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

# UTM Parameters

> Track campaign performance with UTM parameters and the UTM Builder tool

## What is it?

UTM parameters are short text codes added to a URL so you can measure where traffic comes from. They work with Google Analytics and other analytics tools, and are not affected by third-party cookie changes.

## Why would I use it?

UTM parameters help you see which channels and campaigns drive engagement or conversions. Use them to compare email vs social vs paid search, or to A/B test different links that point to the same page.

## When should I use it?

Use UTM parameters when you run campaigns across more than one channel — ads, email, social posts, QR codes, partner links, and more.

## UTM parameters

| Parameter | Example | What it means |
| - | - | - |
| **utm\_source** | `google` | Where traffic comes from — search, social, newsletter, etc. |
| **utm\_medium** | `cpc` | Channel type — e.g. cpc, email, or social |
| **utm\_campaign** | `spring_sale` | Campaign, promo, or slogan name |
| **utm\_term** | `running+shoes` | Paid search keywords (optional) |
| **utm\_content** | `logolink` | Differentiate ads or links that share the same URL (optional) |
| **utm\_id** | `abc.123` | Optional ID for a specific ads campaign |

**Tips**

* Prefer lowercase letters, numbers, and underscores for consistent reporting.
* Complete **Source** and **Medium** so traffic shows clearly in Komo analytics.
* You can add parameters to card share links and Hub share links from those share modals.

## How to build a campaign URL in Komo

1. Open your workspace and go to **Tools**.
2. Open **UTM Builder**.
3. Enter the **Website URL** you want people to visit.
4. Fill in **Source**, **Medium**, and any other fields you need. Placeholders show common examples.
5. Copy the **URL Preview** into your ads, emails, social posts, or designs.

The preview updates as you type. You can also edit UTM parameters when sharing a Hub or Card.

## Example

```
https://www.example.com/spring?utm_source=newsletter&utm_medium=email&utm_campaign=spring_sale
```

This link tells analytics the visit came from a newsletter email promoting the spring sale.


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