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

# UTM Parameters

> Add tracking parameters to the link of every ad, and save them as UTM templates to reuse.

UTM parameters are added to the web link of your ads so your analytics tools know where a visitor came from. On the [Launch page](https://docs.adstellar.ai/guides/launch/overview.md) you enter them once in the **Ad setup** card and they are added to the link of every ad.

## What UTM parameters are

They are pairs of a name and a value, joined with `&`:

| Parameter | Purpose | Example value |
| - | - | - |
| `utm_source` | Where the visitor came from | `facebook` |
| `utm_medium` | The kind of traffic | `paid` |
| `utm_campaign` | The campaign | `{{campaign.name}}` |
| `utm_content` | The ad | `{{ad.name}}` |

You can add any other parameter your tracking needs, in the same way.

## Add UTM parameters

In the **Ad setup** card, type them in the **UTM parameters** field on one line, without a `?` in front:

```
utm_source=facebook&utm_medium=paid&utm_content={{ad.name}}
```

The field takes up to 2,000 characters.

### Values Meta fills in

Under the field there is a row of buttons. Click one to insert a value that Meta fills in when the ad is shown:

| Value | What Meta puts there |
| - | - |
| `{{campaign.id}}` | The Meta campaign ID |
| `{{campaign.name}}` | The campaign name |
| `{{adset.id}}` | The Meta ad set ID |
| `{{adset.name}}` | The ad set name |
| `{{ad.id}}` | The Meta ad ID |
| `{{ad.name}}` | The ad name |
| `{{placement}}` | Where the ad was shown (feed, stories and so on) |
| `{{site_source_name}}` | The platform (facebook, instagram and so on) |

## UTM templates

Save the parameters you use often as a template. Use the **UTM templates** menu under the field:

* **Save as template…** saves what is in the field under a name.
* Pick a template under **Load a template** to fill the field. If that would replace something you entered, it asks first.
* **Manage templates…** lets you rename, replace or delete templates.

A UTM template holds the UTM parameters only, not the web link or the display link, so it works with any landing page. UTM templates are shared with your team and work with every ad account in the workspace.

## Different parameters for one ad

Click an ad and change **UTM parameters** in its pop-up, or edit the **URL tags** column in Table mode. See [Change one ad or many](https://docs.adstellar.ai/guides/launch/edit-ads.md).

## Good to know

* [Instant form](https://docs.adstellar.ai/guides/launch/instant-forms.md) ads have no web link, so they have no UTM parameters.
* To save the UTM parameters together with the web link, Page and copy for one ad account, use **Save as default for this ad account**. See [Ad setup](https://docs.adstellar.ai/guides/launch/ad-setup.md#a-default-for-each-ad-account).
* When you launch through the [Agent](https://docs.adstellar.ai/agent/launch-campaigns.md), enter them in **URL parameters** on the launch form in the chat.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.