UTM Parameters
UTM parameters tag your links so analytics tools can tell campaigns apart. Shortn
supports the standard set: utm_source, utm_medium, utm_campaign, utm_term,
utm_content, and utm_id.
When a visitor opens the link, Shortn adds the UTM parameters you’ve set to the destination URL. The rest of the destination’s address is kept exactly as it is, so signed or order-sensitive addresses keep working.
Add UTM parameters to a link
Set UTM parameters on a link from its advanced settings, either by typing them in or by applying a template. Each value can be up to 100 characters, without line breaks; spaces at either end are removed.
Parameters added to the short link
Anything added to the short link’s address is passed on to the destination. Share
https://shtnl.ink/abc?utm_source=linkedin in one place and
https://shtnl.ink/abc?utm_source=newsletter in another, and each visitor arrives with
the source they came from. This works on every link, for any parameter (ref, coupon,
gclid and so on), not only UTM.
When the same parameter is set in more than one place, the closest one to the visitor wins:
- the value added to the short link,
- then the link’s UTM parameters (or its template),
- then the value already in the destination URL.
A few parameters are never passed on:
qr,bot,shortn_continueandsecurity_continue, which Shortn itself uses on the short link;- the conversion tracking parameters (
snt_click_id, andclient_reference_idormetadata_snt_click_idon Stripe and Dodo checkouts), which only Shortn sets, so that no one can attach someone else’s click to a sale.
A query longer than 2,048 characters isn’t passed on.
UTM parameters in your analytics
Each click records the UTM parameters the visitor actually arrived with, after the order above. One link shared in several places therefore shows each source, medium or campaign separately in your analytics. Recorded values are cut to 100 characters.
UTM templates
A UTM template is a saved set of UTM parameters with a name, so you don’t retype the same values for every link. A template belongs to a workspace and, optionally, to one or more teams in it.
- Create and manage templates from Organize → UTM Templates in the sidebar. Select Create new, choose where the template belongs, then set its values.
- Apply a template to a link to fill in its UTM fields at once.
- While a link uses a template, its UTM values are the template’s: they can’t be changed on the link alone. Editing the template updates every link that uses it.
- To change a parameter on one link, remove the template from that link first. The link keeps the values as its own, and you can then edit them.
- To change the workspace or teams a template belongs to, use Change placement. If links that use it would lose access, choose whether they keep its values as their own or lose them.
Deleting a template
Select the trash icon on a template to delete it. Deleting is permanent: a deleted template can’t be recovered. If links use the template, choose what happens to them:
- Keep the values on the links (the default): each link keeps the template’s UTM values as its own, no longer tied to a template. Visitors see no change.
- Remove the values from the links: the links lose those UTM values, so visitors no longer arrive with them.
With the API, DELETE /api/v1/utm-templates/{id} keeps the values, and ?links=clear
removes them (requires the utm-templates:write scope). The response’s links_updated
says how many links were changed.
Template limits
Each plan sets how many UTM templates you can save:
| Plan | UTM templates |
|---|---|
| Free | 3 |
| Starter | 25 |
| Professional | 100 |
| Agency | 500 |
See plans.