Skip to content

UTM parameters and forwarding ​

See the order UTM parameters are added in, which value wins for the same name, and how to forward a visitor's parameters to the destination.

Link Manager Pro adds UTM parameters to the destination at the moment a visitor goes through a short link. It can also forward query parameters from the address the visitor opened through the redirect. UTM parameters are tags like utm_source=newsletter in a page's address, which analytics tools can read. They're never written into your Destination URL: they're added on each click, so a change applies from the next click.

In what order are UTM parameters added? ​

On every click, Link Manager Pro adds parameters to the destination in four steps. For the same parameter name, the later one wins, and each step also replaces a parameter of that name already in the Destination URL.

  1. Your Site-wide UTM parameters.
  2. The link's own UTM parameters.
  3. The affiliate's UTM parameters, when the visitor goes to that affiliate's domain.
  4. The parameters in the address the visitor opened, when the link has Forward the visitor’s query parameters to the destination on.

An empty field on a link or an affiliate never replaces anything. Forwarded visitor parameters replace everything before them, utm_campaign included, unless the forwarded value is empty.

Here's one click worked through. The link goes to https://example.com/deal, and example.com is an affiliate. To keep it short, the affiliate has no tag; a tag already in the Destination URL stays first in the address. The visitor opens yoursite.com/link/deal?utm_medium=email&sub=42.

StepWhat it addsWhat changes
1. Site-wideutm_source=blog&utm_medium=shortlinkBoth are added
2. The linkSource newsletter, Campaign spring_saleblog becomes newsletter; Campaign is added
3. The affiliateContent partner_boxContent is added
4. Forwardedutm_medium=email&sub=42shortlink becomes email; sub is added

The visitor lands on https://example.com/deal with these parameters, in this order:

?utm_source=newsletter
&utm_medium=email
&utm_campaign=spring_sale
&utm_content=partner_box
&sub=42

The same order applies in two special cases:

  • When a routing rule matches, the parameters go on the rule's destination. The affiliate's are added only when the link's Destination URL and the rule's destination are both on the affiliate's domain.
  • A redirect you add under Redirects has no UTM fields and doesn't forward the visitor's parameters. It gets the site-wide parameters (to your own pages only with Add them to redirects within this site on) and an affiliate's.

A short link's own tags live in the UTM parameters section of its form. They go on every click of that link, whatever the destination.

Link Manager › Short Links
  1. Select Edit on the link's row, or New short link for a new one.
  2. Open UTM parameters.
  3. Choose a saved campaign in Select campaign…, or enter values in Source (utm_source), Medium (utm_medium), Campaign (utm_campaign), Term (utm_term) and Content (utm_content). Picking a campaign fills all five fields and replaces what's in them (Campaigns).
  4. Check Preview 1. It shows the Destination URL with this link's tags.
  5. Select Save changes (Create short link for a new link).
The UTM parameters section of the Edit short link form with five tags filled in, marked: 1 the Preview of the destination with those tags
A link's own UTM tags, and the Preview of the destination they're added to.

Preview shows only this link's tags. Site-wide, affiliate and forwarded parameters are added later, at the redirect. The Short Links list and the link report show each destination with the site-wide and affiliate parameters already added, as visitors get it.

Each field takes up to 255 characters. HTML tags and percent codes like %20 are removed when you save, so write values without them. Link Manager Pro has no UTM templates to save or load. To reuse a set of values, save a campaign with default UTM values and pick it in Select campaign….

Site-wide and affiliate UTM parameters ​

Site-wide parameters go on every short link click, and an affiliate's go on every click to that affiliate's domain. Neither needs a change to your links.

  • Site-wide UTM parameters sit under Link Manager › Settings › Redirection, which only administrators see. You write them as utm_source=yoursite&utm_medium=shortlink, and any parameter name works. A short link to one of your own pages gets them too. A redirect to your own pages gets them only with Add them to redirects within this site on. It's off on new sites. A site that had Link Manager Pro before keeps adding them until you turn it off. Every setting is in Redirection settings.
  • An affiliate's UTM parameters are set in its UTM parameters section under Link Manager › Affiliates, up to 200 characters each. They replace a link's own value for the same parameter, utm_campaign included. So your analytics tool can show the affiliate's campaign instead of the link's (Affiliates).

Forward query parameters through the redirect ​

With Forward the visitor’s query parameters to the destination on, everything after ? in the address the visitor opened goes on to the destination, as the last step. It's off on a new link, and you turn it on per link.

  1. Open the short link with Edit.
  2. Open Schedule & access.
  3. Under Forward query parameters, turn on Forward the visitor’s query parameters to the destination.
  4. Select Save changes.

What it passes and what it doesn't:

  • Every parameter, not only utm_ ones: ?sub=42 and ?ref=mail go through too.
  • Not pid. Link Manager Pro uses it to tell which post a click came from.
  • A forwarded parameter replaces one of the same name from any earlier step and from the Destination URL.
  • An empty one never blanks a parameter the address already has. A visitor who opens ?utm_source= still gets the link's utm_source. A blank name the destination doesn't have yet is passed.
  • A plain name sent twice goes through once, with its last value.
  • With the switch off, the visitor's parameters stop at your site. The destination gets its own parameters plus the ones Link Manager Pro adds.

The link report shows whether it's on: see Forward query parameters under At a glance. The network buttons under the report's Share add utm_source with the network's name (for example facebook) and utm_medium=social to the short link. Those reach the destination only when the link forwards parameters.

What visitors and your analytics see ​

Visitors open the short link, and their browser is sent on to the destination with all the parameters. So the destination's address, as the browser shows it, carries the tags. The short link you share stays short.

  • Analytics tools on the destination site, such as Google Analytics, can read the tags from that address, as long as the destination keeps them. Link Manager Pro doesn't send anything to them itself. When the destination is a partner's site, it's the partner's analytics that can see them.
  • Link Manager Pro's own reports keep the visitor's tags with every recorded click. These are the utm_source, utm_medium, utm_campaign, utm_term and utm_content in the short link address they opened. That happens whether forwarding is on or off, while Click tracking is on (Link Manager › Settings › Tracking).
  • Campaign traffic in the link report shows each Source, Medium and Campaign's share of clicks. It counts Source, Medium and Campaign separately: a click that arrived with that tag counts under it, and any other click counts under the link's own value, if the link has one. Site-wide and affiliate parameters aren't counted there.
  • UTM parameters added under At a glance lists the link's own tags, then the affiliate's when the destination is on an affiliate's domain. Site-wide parameters aren't listed there.
  • Campaigns count clicks by the link's own Campaign (utm_campaign) value.

So the numbers can differ for good reason. An affiliate's or a visitor's utm_campaign can replace the link's. Your analytics tool can then show that campaign, while Campaigns still counts the click under the link's own.

Details ​

Where each kind of parameter is set, and its limits.

ParametersWhere you set themDefaultAdded toLimit
Site-wide UTM parametersSettings › RedirectionEmptyEvery short link click; redirects to other sites; redirects to your own pages only with the switch onOne line of name=value pairs; HTML tags removed; percent codes kept
A link's UTM parametersThe short link formEmptyEvery click of that link, on its destination or a routing rule'sFive fields, 255 characters each
An affiliate's UTM parametersAffiliatesEmptyClicks to the affiliate's domain, from short links and redirectsFive fields, 200 characters each
Forwarded visitor parametersForward the visitor’s query parameters to the destination in the short link formOffClicks of that linkEvery parameter except pid; an empty value never replaces an existing parameter; a repeated name passes once, with its last value
Recorded visitor tagsNothing to setKept while Click tracking is onThe click record, for Campaign trafficThe five utm_ names, 191 characters each
  • Link Manager Pro encodes each value once, so a space or an & inside a value stays part of that value.
  • The redirect sends no-cache headers, so browsers don't reuse an old redirect, and the next click gets your latest values.
  • The QR code (QR code in the list, Download QR in the report) holds the plain short link. Site-wide parameters are still added when someone scans it, at the redirect.

Get more out of it ​

  • Share one link in several places. Turn on Forward the visitor’s query parameters to the destination, then share yoursite.com/link/deal?utm_source=newsletter in your newsletter and ?utm_source=podcast in your show notes. The visitor's Source replaces the link's, and Campaign traffic splits the clicks by Source.
  • Keep the split in your own report only. Leave forwarding off and share the same tagged addresses. Campaign traffic still records each Source, while the destination gets your usual parameters, not the visitor's.
  • Pass a sub ID to a partner. With forwarding on, yoursite.com/link/deal?subid=spring passes subid to the partner's site, next to your UTM tags.
  • Avoid typos. Pick campaigns in Select campaign… instead of typing values, so one campaign never ends up under two spellings.
  • Know what forwarding passes. It passes every parameter on the address, including ones other sites add to links shared there. If a destination rejects parameters it doesn't know, leave forwarding off for that link.

If something goes wrong ​

  • If a tag is missing in your analytics, then check the destination's address after a click. An affiliate's value or a forwarded one may have replaced the link's. A redirect to your own pages also needs Add them to redirects within this site on.
  • If your analytics shows another campaign than Campaigns does, then an affiliate's or a visitor's utm_campaign replaced the link's in the address. Leave the affiliate's Campaign (utm_campaign) empty, or turn off forwarding on that link.
  • If a visitor's parameters don't reach the destination, then turn on Forward the visitor’s query parameters to the destination on that link. Redirects you add under Redirects don't forward, and pid is never passed.
  • If a value lost characters after saving, then it had an HTML tag, or a percent code in a link's own field. Write it without them. A + arrives as a space.
  • If Campaign traffic says No campaign data yet, then none of the recorded clicks carries a Source, Medium or Campaign, from the visitor's address or from the link itself. A link's own Term and Content don't count there. Give the link a Source, Medium or Campaign, and make sure Click tracking is on.

More fixes are on Troubleshooting.