# Short links

{% hint style="warning" %}
Short links are available for SMS, WhatsApp, Push and RCS messages
{% endhint %}

By default, when you add a link to a message template, we shorten the link so that it can be used for link click tracking

Shortened links will always be a Bird domain that looks similar to this: `brdX.eu`.

For example, the link <https://docs.bird.com/applications> might be shortened to something like this: `brd1.eu/psaH7QJ`.

### Branded subdomains

Branded subdomains combine a phrase that's representative of your brand, such as 'Bert's Bookshop' with our `brdX.eu` domain. Links that use branded subdomains might look like this: `bertsbooks.brd3.eu/hufR276`.

{% hint style="info" %}
The shorter your subdomain, the more space you'll have in your message for the rest of your content.
{% endhint %}

#### Set up a branded subdomain

{% hint style="danger" %}
Make sure that the subdomain you use is representative of your brand, or your account will be banned.
{% endhint %}

* From the sidebar, click **Settings**.
* Click the **Marketing > Custom Domains > Short links**

<figure><img src="/files/kGZz2vSHd3i01YIbXoGj" alt="" width="214"><figcaption></figcaption></figure>

* Under 'Branded subdomain', click **Add**.

<figure><img src="/files/Z7xNlqhWJrcGRLgZ4G1W" alt=""><figcaption></figcaption></figure>

* Enter a subdomain in the below form:

<figure><img src="/files/n6Qg64wUUAwkcYN6mIAp" alt=""><figcaption></figcaption></figure>

* Check the preview, then click **Create**.

### Branded domains

Branded domains require additional configuration in your DNS records, but give you complete control over the appearance of your short links. Once set up, your domain name will replace the `brdX.eu` domain in your short links.

So, instead of looking like this: `bertsbooks.brd3.eu/hufR276`

Your short links will look like this: `bertsbooks/hufR276`

#### Set up a branded domain

{% hint style="warning" %}

* You must use your own domain.&#x20;
* To set up a branded domain, you will need access to your DNS settings.
  {% endhint %}

1. Navigate to **Settings > Marketing > Custom domains > Short links**

<figure><img src="/files/rO7sEEV6prkw0m7qhHbB" alt=""><figcaption></figcaption></figure>

1. Click the **Short links** tab.
2. Under Short link > click **Add**.
3. Enter your domain, such as `bird.com`&#x20;
4. Click **Create**.

<figure><img src="/files/EXEpIXUxILtw7uoyjyZj" alt=""><figcaption></figcaption></figure>

1. Copy the **Validation code TXT record** and add it to your DNS settings as a TXT record.
2. Copy the **A record** and add it to your DNS settings.
3. Click **Verify and close**.

<figure><img src="/files/KxiQQyFW7iCNl4PqPG7t" alt="" width="375"><figcaption></figcaption></figure>

DNS records may take some time to propagate. Once the DNS records are verified this domain will become active. In the meantime, your branded domain will be marked as 'Pending'.

### Adding branded links to a campaign

If you've kept the link shortening ON for WhatsApp, Push or RCS message templates, any link added to campaign message template will be automatically shortened.

<figure><img src="/files/u5Um0cJe5ZfoihgBFg4n" alt="" width="375"><figcaption></figcaption></figure>

For SMS campaigns, the link shortening toggle is available in campaign itself when building SMS content.

<figure><img src="/files/TJMMM2wJYawvLMtbFCYT" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
Turning link shortening off will disable link click tracking
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bird.com/applications/campaigns/campaigns/concepts/short-links.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
