Three things to know before you start:
✅ Editing UTM parameters at the campaign level does not trigger an ad review. Make your changes there.
⚠️ Editing UTM parameters at the item / individual URL level does trigger an ad review — avoid making changes there.
🚫 Do not set UTM parameters at both the campaign level and the item/individual URL level. Taboola will drop some parameters, causing inaccurate data. Set them at the campaign level only, and remove any existing parameters at the item level.
Parameters
If you are not using UTM parameters yet, or want to optimise your existing setup, use the full snippet:
utm_source={site}&utm_medium=taboola&utm_campaign={campaign_name}&klar_source=taboola&klar_cpid={campaign_id}&klar_agid={campaign_item_id}
⚠️ Do not add a ? at the beginning — Taboola adds this automatically. Do not use # in your naming convention — it cuts off everything after it in the URL.
If you already have UTM parameters, make sure these are either already present or appended to your existing parameters:
utm_source=taboola OR utm_medium=taboola
utm_campaign={campaign_name}
klar_source=taboola
klar_cpid={campaign_id}
klar_agid={campaign_item_id}
Example:
Below is an example of how adding the required parameters to existing parameters looks like with the added parameters being bold:
utm_source=taboola&utm_medium=referral&utm_campaign={campaign_name}&klar_source=taboola&klar_cpid={campaign_id}&klar_agid={campaign_item_id}
⚠️ Naming conventions
Certain characters in UTM values silently break tracking. Use hyphens (-) or underscores (_) in your campaign names — nothing else.
Character | Recommended? | Reason |
| ✅ Yes | Safe and clean |
| ✅ Yes | Safe and clean |
| ⚠️ Avoid | May be interpreted as a space — |
| ❌ No | Starts the URL fragment — breaks all tracking after it |
Spaces | ❌ No | Require URL encoding |
Avoid umlauts and accented characters (ä, ö, ü, ç) in UTM values — they get URL-encoded and corrupt your campaign names in reports.
Implementation
There is no bulk editing feature. Update each campaign individually:
Create a new campaign or open an existing one
Inside the campaign, go to the Tracking Code section
Paste the parameters from above into the Tracking Code field
Save the campaign
Repeat for all your remaining campaigns