---
title: "Hyperlink Elements"
slug: "hyperlink-elements-1"
updated: 2026-10-08T12:08:37Z
published: 2026-10-08T12:08:37Z
canonical: "help.mail-and-deploy.com/hyperlink-elements-1"
---

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

# Hyperlink Elements

### General

A hyperlink element can be used to insert a hyperlink into the report document.

### Properties

Every hyperlink element has the following properties:

| Name | Description |
| --- | --- |
| Name | The name of the chart element. This name will be displayed in the tree hierarchy of the content explorer of the [Report Designer](/release36/docs/report-designer). |
| Code | The code of the chart element. There must be no other report element within the same report with the same code. The code is used to reference the report element from within a [Template](/release36/docs/templates-2) (see below). |
| Condition | An optional condition [Expression](/release36/docs/introduction-to-mail-and-deploy-expressions); if it returns *True* or *1* the condition is considered to be fulfilled and the chart will be included in the report document. If it returns something other than *True* or *1* the exclusion settings (see below) will be applied. If you leave this property empty, the condition is considered to be always fulfilled. The condition expression is evaluated after the preparation [Actions](/release36/docs/introduction-to-actions) of the chart element have been executed. |
| Preparation Actions | A list of [Actions](/release36/docs/introduction-to-actions) that will be executed before the chart element will be processed. |
| Fail On Filter Exception | Determines what shall happen if an exception occurs when executing a preparation action that performs a filter (e.g. because the value to which you want to filter does not exist). When enabled, an exception will be thrown and the report document creation will be cancelled; when disabled, the exclusion settings (see below) will be applied. |
| URL | An [Expression](/release36/docs/introduction-to-mail-and-deploy-expressions) that returns a [String](/release36/docs/string) that contains the URL of the hyperlink. |
| Text | An [Expression](/release36/docs/introduction-to-mail-and-deploy-expressions) that returns a [String](/release36/docs/string) that contains the displayed text of the hyperlink. |
| Exclusion Behavior | *Exclude Element*. When choosing this option and the hyperlink element needs to be excluded, the element will simply be ommitted from the output and an optional replacement text (see below) may be inserted. Exclude Row(s). If you choose this option, the row that contains the reference to the report element will be remvoed from the report document. Exclude Sheet. If you choose this option, the sheet that contains the reference to the report element will be removed from the report document. |
| Replacement Text | An optional [Expression](/release36/docs/introduction-to-mail-and-deploy-expressions) that returns a [String](/release36/docs/string) that contains the replacement text to insert into the report document when the report element needs to be excluded (e.g. if the condition is not fulfilled). Not all exclusion behaviors support a replacement text. |

### Insertion

You can drag & drop a hyperlink element from the content explorer of the Report Designer into a template. A placeholder for the element will be inserted with the following syntax:

Hyperlink Element Placeholder

%%Code%%

### Visitor URL Hyperlinks

Hyperlink elements can be used in combination with [Visitor URLs](/release36/docs/visitor-urls). This allows to include a hyperlink in the created report document that leads the user to a [Datasource](/release36/docs/introduction-to-datasources) object.

**Example:** You can create a visitor URL that opens a specific sheet of a [Qlik Sense Datasource](/release36/docs/introduction-to-qliksense) in the web browser.

You can achieve that by using a [Datasource Object Visitor URL Placeholder](/release36/docs/datasource-object-visitor-url) in the [Expression](/release36/docs/introduction-to-mail-and-deploy-expressions) used as the *URL* property:

Datasource Object Visitior URL Placeholder Example

[Datasource].[MyDatasource].[VisitorURL].[MyObjectID]

The above example would return a [String](/release36/docs/string) that contains the visitor URL for the object with object ID MyObjectID in the [Datasource](/release36/docs/introduction-to-datasources) named MyDatasource.