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

# Track email campaigns with URL parameters

> Track email campaigns with URL parameters: add comet_source=email to your email links to see which emails drive leads and sales in Cometly.

A URL parameter is a short tag added to the end of a link. To track email campaigns with URL parameters, you add `comet_source=email` to the links in your emails, so Cometly records each click as a visit from the Email source.

This lets you see how many leads and sales your emails produce, next to your ad platforms and other sources. With a few extra parameters, you can also compare one campaign or one email against another.

## Add the Cometly email parameter

Append the following URL parameter to every link in the emails you send:

```text theme={null}
?comet_source=email
```

You can also copy the parameter in Cometly: go to **Setup**, open step 4 **Add URL parameters to your ads**, choose **Email** in the **Select integration** dropdown and click **Copy Parameters**.

> [!TIP]
>
> **Example:** if your email contains this link:
>
> `https://www.cometly.com/demo`
>
> append the URL parameter like so:
>
> `https://www.cometly.com/demo?comet_source=email`

Add the parameter to each new email you send, not only the ones you have today.

Using Klaviyo? You can have it add the parameter for you. See [Email and SMS tracking with Klaviyo](https://docs.cometly.com/guides/url-parameters/klaviyo-email-and-sms.md).

## Track specific email campaigns and emails

For more granular email reporting, add more URL parameters to identify the specific email or the email broadcast or campaign, such as:

* `utm_campaign`
* `utm_content`
* `comet_custom`

> [!TIP]
>
> **Example:** if your email contains this link:
>
> `https://www.cometly.com/demo`
>
> append the URL parameters like so:
>
> `https://www.cometly.com/demo?comet_source=email&utm_campaign=emailcampaign1&utm_content=email1`

## Does Cometly track the email source without the email parameter?

Yes.

In addition to `comet_source=email`, Cometly can detect email traffic automatically from the referring domain.

When a contact clicks a link in a webmail client or email service, Cometly checks the referrer and classifies the visit as an Email touchpoint if it matches a known email domain. This includes Gmail (`mail.google.com`), Yahoo Mail, Mailchimp (`mailchi.mp`) and other common webmail providers such as Earthlink, Telstra, Spectrum and Orange.

As a catch-all, any referrer that contains `email.` in the domain is also classified as Email. So even without Cometly parameters in the URL, clicks from webmail clients are still attributed to the Email source automatically.

## Email reporting

To report on your email campaigns, open the [Report Builder](https://docs.cometly.com/guides/report-builder/build-a-report.md) and select the **Email** source under **Sources**.

If you added the extra URL parameters shown above, you can report on specific campaigns or emails with the [**URL Parameters** filter](https://docs.cometly.com/guides/report-builder/url-vs-url-parameters-filters.md) in the Report Builder.

## Check it worked

Once contacts click the links that carry `comet_source=email`, open the Report Builder and select the **Email** source under **Sources**. Your email traffic appears under that source. If you added `utm_campaign`, `utm_content` or `comet_custom`, a **URL Parameters** filter on one of those values narrows the report to that campaign or email.

## Frequently asked questions

### What if my email link already has URL parameters?

Add the Cometly parameter after the existing ones with `&` instead of `?`, for example `&comet_source=email`. A link has one `?`, before the first parameter, and every parameter after that is joined with `&`.

### Can Klaviyo add the Cometly email parameter automatically?

Yes. In Klaviyo's UTM tracking settings you can add `comet_source` with the **Message type** value, and Klaviyo then adds `comet_source=email` to every email link for you. See [Email and SMS tracking with Klaviyo](https://docs.cometly.com/guides/url-parameters/klaviyo-email-and-sms.md) for the steps.

### What is the comet\_custom parameter?

`comet_custom` is a custom parameter: an identifier you choose, such as `comet_custom=summerpromo`, and add to a link. It lets you see the results of one campaign or promotion with a **URL Parameters** filter in the Report Builder. See [Track custom parameters](https://docs.cometly.com/guides/report-builder/custom-parameters.md).

## Next steps

* [Have Klaviyo add the email and SMS parameter for you](https://docs.cometly.com/guides/url-parameters/klaviyo-email-and-sms.md)
* [Build a report in the Report Builder](https://docs.cometly.com/guides/report-builder/build-a-report.md)
* [Filter reports by URL or URL parameters](https://docs.cometly.com/guides/report-builder/url-vs-url-parameters-filters.md)
* [Track custom parameters](https://docs.cometly.com/guides/report-builder/custom-parameters.md)
* [Track SMS campaigns with URL parameters](https://docs.cometly.com/guides/url-parameters/sms.md)

Still have questions or need a hand? We're happy to help. Reach our team at [support@cometly.com](mailto:support@cometly.com).


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