Skip to content

UTM passthrough

Automatically pass UTM parameters to destination URLs

Use with AI

Use with AI

Ready-made prompts Connect your AI to Pasilobus Install the CLI

This page

View as MarkdownPlain text of this page Open in ClaudeAsk about this page Open in ChatGPTAsk about this page

Ready-made prompts

Fill in the parts in angle brackets, then paste into any assistant.

Step by step on your store

Read https://help.pasilobus.com/link-shortener/utm-passthrough.md. Walk me through UTM passthrough in Short Links for my store, step by step. My theme is <theme name> and I want <what you want to happen>.

Ask your own question

Read https://help.pasilobus.com/link-shortener/utm-passthrough.md. Answer this about Short Links on my store: <your question>.

Ask Shopify Sidekick

In your Shopify admin, ask Sidekick about Short Links. It searches these guides.

Our MCP server lets Claude, ChatGPT, OpenClaw and other MCP clients use your Pasilobus apps. It is in beta and open to every Pasilobus account: you sign in with it when your assistant asks. Tools that change your store are marked as changes, so your assistant asks you first.

https://cloud.pasilobus.com/mcp

In Claude Code, add it, then run /mcp to sign in:

claude mcp add --transport http pasilobus https://cloud.pasilobus.com/mcp

In Claude on the web or desktop, go to Customize › Connectors › Add custom connector and paste the address. In ChatGPT, OpenClaw or another client, add it as a custom connector (MCP) with the same address.

npm install -g pasilobus

Run your apps from the terminal or a coding agent. These only read, so they are safe to try:

pasilobus link-shortener links

Find short links by name, destination or key

pasilobus link-shortener plan

Which Short Links plan the store is on, and what Pro adds

pasilobus link-shortener stats

Clicks, busiest links and top traffic sources

pasilobus apps lists your apps on the store; pasilobus <app> help lists what each app can do. How it works

On this page
  1. What it does
  2. Which parameters are forwarded
  3. Turning it on and off
  4. Where it earns its keep
  5. Practical notes
  6. Next Steps

Normally you decide a link's tracking when you create it, which means one link per channel. UTM passthrough turns that around: leave the destination plain, and any UTM parameters you add to the short URL are carried through to the destination on the way. One short link can then serve every channel with different tracking on each.

What it does

Your short link: yourstore.com/sale

Its destination: yourstore.com/collections/winter-sale

You share: yourstore.com/sale?utm_source=facebook&utm_medium=post

The visitor lands on: yourstore.com/collections/winter-sale?utm_source=facebook&utm_medium=post

The parameters travel through the redirect, so Google Analytics attributes the session to Facebook.

Which parameters are forwarded

Six, and only these six:

  • utm_source
  • utm_medium
  • utm_campaign
  • utm_term
  • utm_content
  • utm_id

Anything else you put on the short URL is ignored and does not reach the destination. Two more rules are worth knowing:

  • Existing parameters win - If the destination already carries utm_source, the one on the short URL is not applied. Passthrough only fills in what is missing.
  • Encoding is handled for you - Parameters are rebuilt properly onto the destination, whether or not it already had a query string.

Turning it on and off

  1. Open Short Links and go to Settings
  2. Open UTM Passthrough
  3. Use the toggle to switch it on or off

It is on by default, so there is normally nothing to do. Turning it off means UTM parameters on a short URL are ignored and visitors land on the plain destination.

That page also lists the exact parameters that get forwarded, so you can check it rather than guess.

On the free plan the toggle is disabled and the page offers an upgrade link instead — the feature needs a paid plan.

Where it earns its keep

  • One link across many channels - Share yourstore.com/shop?utm_source=instagram in a bio, ?utm_source=newsletter in an email and ?utm_source=facebook in a post, all pointing at the same link
  • Influencer and affiliate tracking - Give everyone the same short link with their own utm_source, and compare them in Google Analytics without creating a link each
  • Ad platforms - Let the platform append its own tagging to the URL you gave it; whatever it adds is carried through
  • A team sharing one link - Nobody has to come back to the app to get a new link for a new campaign
  • Print and packaging - This is the strongest case. A printed short URL cannot be changed, but the tagging on it can be decided per print run rather than being baked into the link forever.

Practical notes

  • Do not double-tag - Either keep destinations plain and rely on passthrough, or tag destinations and skip it. Doing both means the destination's tags quietly win and your channel tagging disappears.
  • Keep naming consistent - Lowercase, one separator, the same vocabulary everywhere, or your reports fragment across near-identical sources
  • Test before a big send - Create a link with a plain destination, follow it with ?utm_source=test&utm_medium=test on the end, and check the address bar where you land

Next Steps

Talk to a person.

The people who build our apps answer support themselves. Send us a message or email us, and a person replies, usually within one business day. There's no chat.