---
title: "Add a link"
slug: "add-a-link"
abstract: "Learn how to add links by directing to a URL, email address or button item."
---
# Add a link

You can add links to your newsletters and landing pages. When recipients click these, they generate valuable information about how they interact with your campaigns.

You can add a URL link or an email address link.

## Add a URL link

To add a URL hyperlink:

1. In the editor, click the **Items** tab, and then drag and drop a **Text** item in the editing area.
2. Click the text item and type or paste your text.
3. Select the text that you want to display as a hyperlink.
4. In the text toolbar, click ![Icon_Link.png](https://doc.sitecore.com/api/markdown-image/send/en/users/sitecore-send/images/Icon_Link.png).
5. In the **Insert/Edit Link** dialog box, fill in the fields:
    - **URL** - enter the URL of the website you want the link to open.
    - **Text to display** - enter or edit the text you want to display as a link.
    - **Title** - enter a tooltip for text. This text will be shown when the recipient hovers over the link.
    - **Open link in** - select whether the link opens in a new or the current browser window.
    - **Personalization Tags** - select a personalization tag from the drop-down list to add to your link to your newsletter.
6. Click **Save**.

## Add a custom field to a URL for Regular Campaigns

To add a custom field to your existing Link to use within a regular campaign:

For example: *https://subdomain.moosend.com/#recipient:value| fallback#*

The #recipient:value| fallback# custom field allows you to pull in dynamic data specific to the recipient. And the fallback value will be used if no recipient-specific data is available.

1. Insert the URL with the placeholder #recipient:value| fallback# in the content of your campaign.
2. Ensure that the recipient data is available in your mailing list for each specific member.
3. The platform will automatically replace #recipient:value| fallback# with the appropriate data for each recipient. If the data is missing, it will fall back to the specified default value.

## Add a substitution to a URL for Transactional campaigns

To add a substitution to your existing Link to use within a transactional campaign:

For example: *https://subdomain.moosend.com/#key#*

The #key# placeholder will be dynamically replaced with substitutional transactional data.

For example: *order number, purchase details*. There is no fallback in this case, as substitutional transactional data is assumed to be available.

1. Insert the URL with the placeholder #key# where needed in the email content.
2. To ensure the system correctly replaces placeholders like #key# or {{key}} in your content, your payload must include the expected key-value pairs.
3. The platform will replace #key# or {{key}} with the transactional data for each recipient.

> [!tip]
> -   Every placeholder in your content must have a matching key in the payload. If *#key#* exists in your text but *''key''* is missing in the payload, the system won’t be able to replace it.
>
> -   Key names are case-sensitive. Ensure *''Name''* and *''name''*are correctly matched.
>
> -   Unused placeholders will remain visible. If the payload doesn’t contain a value for a placeholder, it will not be replaced.
>
>
> By ensuring your payload includes all necessary key-value pairs, you’ll get a correctly formatted final output.

## Add a link to an email address

To add a link to an email address:

1. In the editor, click the **Items** tab, and then drag and drop a **Text** item in the editing area.
2. Click the **Text** item to display the text toolbar.
3. Enter the email address by typing it directly or pasting your text, and then press Enter. The email address is now formatted as a link.

## Add a link to a button item

To add a link to a button item:

1. In the editor, click the **Items** tab, and then drag and drop a **button** item in the editing area.
2. Click the **button** item to display the button toolbar.
3. Enter the URL into the **button link** field.
4. Check or uncheck the option for the link to open in a new window.

## Add a custom field to a button item for Regular campaigns

To add a custom field to a button item instead of using a URL:

1. In the editor, click the **Items** tab, and then drag and drop a **button** item in the editing area.
2. Click the **button** item to display the button toolbar.
3. Enter the custom field into the **button link** field. For example: *#recipient:DiscountcodeURL| fallback#*
4. Check or uncheck the option for the link to open in a new window.

## Add a substitution to a button item for Transactional campaigns

To add a substitution to a button item instead of using a URL:

1. In the editor, click the **Items** tab, and then drag and drop a **button** item in the editing area.
2. Click the **button** item to display the button toolbar.
3. Enter the substitution into the button link field. For example: *#key#* or *https://subdomain.moosend.com/#key#*
4. Check or uncheck the option for the link to open in a new window.