Key takeaways
- A UTM naming convention needs four rules: lowercase everything, pick medium from a closed list, make source the real platform, and build campaign names from the same parts in the same order.
- Audit before you write it. At Pipe17, about 8,000 contacts showed 5% of utm_source values, 11% of mediums and 10% of campaign names following any convention.
- Ship the standard as a tool. Mine was a command-line linter and a hosted link builder, because a rule people have to remember doesn't survive a busy week.
- The payoff is attribution. A contact's first-touch UTM is the field I fall back on when deal source fields break, and it only works if the values mean the same thing every time.
If you want the rules applied for you, my free UTM builder lowercases every value, keeps mediums to a fixed list and builds the campaign name in the same order every time.
01The UTM naming convention I use
A UTM naming convention is a written rule for what goes in each UTM parameter, so the same campaign always shows up as one row in analytics and the CRM. Mine has four rules: all lowercase, medium from a closed list, source is always the real platform, and campaign names follow period, initiative, asset.
| Parameter | Rule | What it prevents |
|---|---|---|
| Every value | Lowercase, always | One platform or campaign splitting into several rows because of capital letters |
| utm_source | The real platform the click came from, spelled one way | Team names, tool names and campaign names ending up in the source field |
| utm_medium | One value from a closed list. Mine had 11 | New mediums invented per campaign, which breaks every channel report |
| utm_campaign | Three parts in a fixed order: period, initiative, asset. Written as period_initiative_asset | Campaign names only the person who made them can read |
A made-up example of the campaign shape: spring_tradeshow_ebook. The period says when it ran, the initiative says what it was for, and the asset says what was promoted. Because the order never changes, you can split a report on any one of the three.
I'm not reprinting my 11 mediums, because your list should come from your own channels. Start from the values your analytics tool already understands, such as cpc for paid search and email for email, and add a medium only when you can define it in one sentence. utm_content and utm_term are optional. If you use them, put them under the same lowercase rule and write down what each one holds.
02Audit what you have first
At Pipe17 I pulled the UTM values on about 8,000 contacts in HubSpot before writing anything.
| Field | Share of values that followed any convention |
|---|---|
| utm_source | 5% |
| utm_medium | 11% |
| utm_campaign | 10% |
The audit does two jobs. It tells you which mistakes are common enough to need a rule, and it gives you a number to show the people who have to follow the standard. To run one, export every distinct value of each UTM field from your CRM with a count beside it, sort by count, and mark which ones a stranger could read correctly.
03Ship it as a linter and a link builder
A convention in a document depends on people opening the document. I shipped the standard two ways:
- A command-line tool with a linter.The linter checks a link against the rules, so a bad value gets caught before the link goes out.
- A hosted link builder.The same rules behind a web page, for anyone who doesn't work in a terminal.
If you build your own, the linter only has to answer four questions, one per rule. Is every value lowercase? Is the medium on the list? Is the source a real platform name? Does the campaign name have three parts? Anything that fails gets fixed before the link goes out. I build small tools like this with coding agents, and the setup is in Claude Code for marketing.
04Why it matters for attribution
UTMs are only useful if they reach the CRM and stay there. At Pipe17, a first-party cookie stored each visitor's first-touch UTMs, referrer, landing page and Google click ID, and every form posted them to HubSpot with the submission. That made the contact's first-touch UTM a field I could rely on.
It mattered most when other fields failed. About three quarters of deals listed their source as offline, so I worked from contacts: a contact's first-touch UTM is reliable, and so is its association to a deal, even when the deal's own source field is blank. That method only works if the UTM values are clean. The full approach is in B2B marketing attribution for long sales cycles.
05Mistakes the standard is there to stop
- Mixed case. The same platform typed three ways is three rows.
- Source that isn't a platform. A newsletter name or a campaign name in utm_source tells you nothing about where the click came from.
- A new medium for every campaign. Once the list is open, channel reporting stops adding up.
- Campaign names with no order. If one name starts with the asset and the next starts with the period, you can't group either.
- A standard with no tool. If following it means opening a document, most links will skip it.
Cleaning up tracking like this is part of what I do as a B2B demand generation consultant and as a growth marketing consultant.
FAQQuestions people ask
- What is a good UTM naming convention?
- A short one that a tool can check. The standard Farhan Munshi wrote at Pipe17 has four rules: every value is lowercase, utm_medium comes from a closed list of 11 values, utm_source is always the real platform the click came from, and utm_campaign follows a fixed order of period, initiative and asset.
- Should UTM parameters be lowercase?
- Yes. Analytics tools and CRMs group by the exact string, so LinkedIn and linkedin become two rows for one platform. Lowercase everywhere was the first rule in the UTM standard Farhan Munshi wrote at Pipe17, because it removes a whole class of mismatches without anyone having to make a decision.
- What is the difference between utm_source and utm_medium?
- Source is who sent the click and medium is the kind of traffic it was. In Farhan Munshi's standard at Pipe17, source is always the real platform, such as a search engine or a social network, and medium is one value from a closed list. Keeping the two apart is what lets you compare platforms inside one type of traffic.
- How should UTM campaign names be structured?
- Use the same parts in the same order every time. At Pipe17, Farhan Munshi set campaign names as period, initiative, asset. The period says when it ran, the initiative says what it was for and the asset says what was promoted. With a fixed order, a report can be split on any one of the three.
- How do you get a team to follow a UTM convention?
- Take the remembering out of it. Farhan Munshi shipped the Pipe17 UTM standard as a command-line tool with a linter and a hosted link builder, so a link could be built or checked without anyone reading the document. Before the standard, an audit of about 8,000 contacts found only 5% of source values followed any convention.
