Skip to content

UTM parameters not passing

Fix UTM parameters not appearing in destination

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.

Find the cause

Read https://help.pasilobus.com/link-shortener/utm-not-passing.md. On my store, <describe what you see, and on which page>. Using that article, tell me what to check first and what to try next, one step at a time. My theme is <theme name>.

Draft a message to our team

Read https://help.pasilobus.com/link-shortener/utm-not-passing.md. I tried <what you tried> and Short Links still isn't right on <your-store>.myshopify.com. Write a short message to the Pasilobus support team with what I see and what I tried.

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. Check the setting and your plan
  2. Check the destination is not already tagged
  3. Check the parameter is one that gets forwarded
  4. Check the parameters are well formed
  5. Test it end to end
  6. Working without passthrough
  7. Quick checklist
  8. Next Steps

You added UTM parameters to a short URL, followed it, and the address you landed on does not have them. There are four realistic causes, and they are quick to tell apart: the feature is off or unavailable, the destination already carries that parameter, the parameter is not one of the six that get forwarded, or the parameter itself is malformed.

Check the setting and your plan

  1. Open Short Links and go to Settings
  2. Find the UTM Passthrough section

What you see there tells you where you stand:

  • A toggle switched on - The feature is working; move on to the next check
  • A toggle switched off - Switch it on and retest. Passthrough is on by default, so someone has turned it off.
  • A greyed-out checkbox with a Pro badge and "Upgrade to Pro to enable" - Passthrough needs the Pro plan. Until you upgrade, put the parameters in the destination URL instead, as described at the end of this article.

Check the destination is not already tagged

This is the most common cause once the setting is confirmed. Passthrough never overwrites a parameter the destination already has — it only fills in the ones that are missing.

  • The destination is yourstore.com/sale?utm_source=website
  • You share yourstore.com/sale-link?utm_source=facebook
  • The visitor arrives with utm_source=website, because the destination's value stands

To check, open the link in the app and look at Original URL. If it has UTM parameters on it, that is your answer. Since a destination cannot be edited after a link is created, the fix is a new link with a plain destination.

Note that this is per parameter, not all-or-nothing: a destination carrying only utm_source will still accept a utm_medium from the short URL.

Check the parameter is one that gets forwarded

Exactly six parameters are carried through:

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

Anything else on the short URL is dropped, including custom tracking parameters, platform click IDs and your own naming variants. A misspelling counts as "anything else" — utm_med and utmsource are silently ignored.

Check the parameters are well formed

Good:

yourstore.com/sale?utm_source=instagram&utm_campaign=winter_sale_2026

Problematic:

yourstore.com/sale?utm_source=instagram bio&utm_campaign=winter sale!

Fixed:

yourstore.com/sale?utm_source=instagram_bio&utm_campaign=winter_sale
  • Spaces - Replace them with underscores rather than encoding them; it reads better everywhere
  • Punctuation - Avoid #, & and = inside a value unless properly encoded, since each one means something structural in a URL
  • Case - Facebook and facebook are two separate sources in Google Analytics, so pick lowercase and stay with it
  • Structure - One ? to begin, & between each parameter after that

Test it end to end

  1. Confirm the toggle in Settings is on
  2. Create a link whose destination has no UTM parameters at all
  3. Copy its short URL from the app and add ?utm_source=test&utm_medium=test
  4. Follow it in a private browsing window
  5. Look at the address bar where you land, not the page content

If both parameters are there, passthrough is working and the original problem is one of the specific cases above. If they are not, recheck the plan and the toggle before anything else.

Working without passthrough

On the free plan, or when you would rather have the tagging fixed to the link, put the parameters in the destination when you create it:

  • Destination - yourstore.com/collections/sale?utm_source=facebook&utm_medium=social
  • Short link - yourstore.com/sale-fb

Then make one link per channel: sale-fb, sale-ig, sale-email. It is more links to manage, and the tagging cannot be changed afterwards, but it works on every plan. A URL builder such as Google's Campaign URL Builder will assemble the tagged address for you and avoid encoding mistakes.

Quick checklist

  1. UTM Passthrough is switched on in Settings
  2. You are on a paid plan
  3. The destination URL does not already carry that parameter
  4. The parameter is one of the six forwarded names, spelled correctly
  5. No spaces or unencoded punctuation in the values
  6. Tested in a private window, checking the address bar after the redirect

Next Steps

Contact the Short Links team

Still stuck? The people who build Short Links answer support themselves. A person replies, usually within one business day.

Include your store's .myshopify.com address and what you've tried. There's no live chat.