> ## 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.

# Custom URL parameter setup

> Set up a custom URL parameter in Cometly to track newsletters, partners and affiliates, then filter your reports by that source.

Custom source URL parameters let you track traffic that does not come from an ad platform, such as a newsletter, a partner campaign or an affiliate. You add a `comet_custom` parameter to your link, then filter your reports by that value.

A custom URL parameter gives each of these sources its own name in Cometly. That lets you see how many leads, conversions and how much revenue one newsletter, partner or affiliate link produced, so you can decide which ones are worth more of your time and budget.

## Before you start

* Install the Cometly pixel (the small script that records where your visitors come from) on the site your link points to. See [Install and verify the Cometly pixel](https://docs.cometly.com/getting-started/install-pixel.md).

## Set up a custom URL parameter

**1. Choose your custom parameter**

1. In Cometly, go to **Setup** and open step 4, **Add URL parameters to your ads**.
2. Open the **Select integration** dropdown and choose **Custom Tracking**.
3. Under **Custom parameter name**, enter a name for your custom source (for example `newsletter`, `partner_campaign` or `John Smith Affiliate`).

**2. Copy the parameter and add it to your link**

1. Cometly builds the parameter from the name you entered (for example `comet_custom=newsletter`). Click **Copy Parameters**.
2. Add the parameter to the end of the URL you want to track.

**Example:**

```text theme={null}
https://example.com?comet_custom=newsletter
```

If the URL already contains a `?`, add the parameter with `&` instead. See [URLs that already have parameters](https://docs.cometly.com/guides/url-parameters/urls-with-variant-parameter.md).

Add the parameter to every new link you share, not only the ones you have today.

**3. Use the custom parameter in reports**

1. Once traffic starts coming in from the URL, go to the **Report Builder** in Cometly.
2. Under **Filters**, add a **URL Parameters** filter and enter your custom parameter name.
3. View data specific to this parameter, such as conversions, leads and revenue.

## Check it worked

Click your tagged link yourself to test it before you share it widely. Then, in the **Report Builder**, use the **Table** report type, set **Group By** to **URL Parameters** and add a **URL Parameters** filter that contains your custom parameter name. Traffic from the link appears under that parameter.

## Frequently asked questions

### Can I use comet\_custom with other URL parameters on the same link?

Yes. Join the parameters with `&`, for example `comet_source=ig&comet_custom=igbio` to track visits from your Instagram bio. Only the first parameter on a URL starts with `?`.

### What should I name my custom URL parameter?

Use a descriptive, unique name so the source is easy to find in your reports. For example, `comet_custom=blackfriday2025` tells you more than `comet_custom=test`.

### What is the difference between the URL filter and the URL Parameters filter?

The **URL** filter looks at the host and path of the page a visitor landed on. The **URL Parameters** filter looks at the query parameters on the link, which is where `comet_custom` lives, so it is the one to use for custom sources.

## Next steps

* [Use filters to track custom sources](https://docs.cometly.com/guides/report-builder/custom-parameters.md)
* [URL vs. URL Parameters filters](https://docs.cometly.com/guides/report-builder/url-vs-url-parameters-filters.md)
* [Track affiliate conversions](https://docs.cometly.com/guides/report-builder/affiliate-conversions.md)
* [Track email campaigns with URL parameters](https://docs.cometly.com/guides/url-parameters/email.md)
* [Set up URL parameters for all channels](https://docs.cometly.com/getting-started/url-parameters.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.