---
title: "URL"
slug: "url-filter"
updated: 2026-07-31T09:45:58Z
published: 2026-07-31T09:45:58Z
canonical: "learn.servitly.com/url-filter"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://learn.servitly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# URL

Displays URL values in different ways, for example, opening in a new tab or direct download link.

![URL](https://components-manager.servitly.com/components/URL_1/IMAGES/_screenshot?owner=AG_Servitly)

# How it works

This filter and its variants can be applied to *metrics* and *properties* template elements.

The metric/property providing a URL is rendered as an HTML link allowing the user to download or open the target resource.

Without this filter, the values of metrics/properties are printed as string. Null or empty values will generate no HTML element.

# Filter Variants

The set of predefined filter variants that can be used to format values.

| *Download Link* | Converts the URL value into an anchor which allows downloading the resource. **Name**: *downloadLink* **Input Types**: *STRING* **Output Type**: *HTML* ![](https://components-manager.servitly.com/components/URL_1/IMAGES/variants/downloadLink/_image?owner=AG_Servitly) |
| --- | --- |
| *Open in New Tab* | Converts the URL value into an anchor which allows opening the resource into a new browser tab. **Name**: *openInNewTab* **Input Types**: *STRING* **Output Type**: *HTML* ![](https://components-manager.servitly.com/components/URL_1/IMAGES/variants/openInNewTab/_image?owner=AG_Servitly) |

# Custom Variants

New variants can be defined through the following configuration options.

| **Option** | **Description** | **Sample Value** |
| --- | --- | --- |
| *download* | The flag indicating whether the URL target must be downloaded (default false). | true |
| *icon* | The [Font Awesome (5 free)](https://fontawesome.com/v5/search) icon to be displayed along with the label. | fas fa-download |
| *label* | The label displayed instead the URL value. | open |
| *newTab* | The flag indicating whether the URL target must be opened in a new browser page. | true |

  

Example of defining a custom URL filter variants into the [Custom Filters](/docs/custom-filters) component.

```javascript

        exports.pdfLink = UrlFormatter({ "download": true, "icon": "fas fa-pdf" });
    
```