# UTM link builder > How do you tag a link to track a campaign? Build a campaign link with UTM parameters and get a warning before a typo splits your reports. Add utm_source, utm_medium and utm_campaign to any web address, keep your other parameters and the fragment, and check the link for common mistakes. - Page: https://how.box/utm/ - Runs entirely in the browser. - License: HowToolbox's own text and data (titles, explanations, FAQs, tool descriptions and schemas, this file) are CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/); AI training and answers are welcome. Attribute "HowToolbox (how.box)" with a link to the page used. Third-party data keeps its own terms; the name and logo are not licensed. Publisher: HowToolbox, contact@how.box. Terms: https://how.box/about/terms/ ## Inputs Answer link: https://how.box/utm/?url={url}&source={source}&medium={medium}&campaign={campaign}&term={term}&content={content}&id={id}&lower={lower} - `url` (text): The page the link leads to. Example: `https://example.com/pricing`. - `source` (text): utm_source. Example: `newsletter`. - `medium` (text): utm_medium. Example: `email`. - `campaign` (text): utm_campaign. Example: `spring_sale`. - `term` (text): utm_term (optional). Example: `running shoes`. - `content` (text): utm_content (optional). Example: `header_button`. - `id` (text): utm_id (optional). Example: `abc123`. - `lower` (boolean): Write the values in lower case: 1 or 0. Example: `true`. Example answer: https://how.box/utm/?url=https%3A%2F%2Fexample.com%2Fpricing&source=newsletter&medium=email&campaign=spring_sale&term=running+shoes&content=header_button&id=abc123&lower=1 The page computes the answer in the browser: read results from the agent tools below, not from the page HTML. ## Agent tools - `utm_build`: Builds a campaign link with Google Analytics UTM parameters. - MCP, one POST to https://how.box/mcp: `{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"utm_build","arguments":{"url":"https://example.com/pricing","source":"newsletter","medium":"email","campaign":"spring_sale","term":"running shoes","content":"header_button","id":"abc123","lowercase":true}}}` - GET: https://how.box/mcp/run/utm_build?url=https%3A%2F%2Fexample.com%2Fpricing&source=newsletter&medium=email&campaign=spring_sale&term=running+shoes&content=header_button&id=abc123&lowercase=true ## How it works UTM parameters are labels added to the end of a web address. When someone follows the link, analytics tools such as Google Analytics read the labels and credit the visit to a source (where it came from), a medium (the channel) and a campaign (which effort). Source, medium and campaign are the three to always use; term, content and ID are optional extras. The labels are plain text, so spelling matters. Values are case sensitive: Email and email become two different mediums in your reports, and spring_sale and Spring-Sale two campaigns. Pick a naming habit, such as lower case with underscores, and keep to it. The tool encodes spaces and special characters, keeps the parameters already in your address and puts the #fragment last. UTM labels do not hide anything: anyone can read them in the address, so never put personal data in them. Use them for links you control. Links inside your own site can overwrite the original source of a visit, so they are best kept for links that come from outside. ## FAQ **Which UTM parameters are required?** Google advises always setting utm_source, utm_medium and utm_campaign. utm_term, utm_content and utm_id are optional. **Does the case of a value matter?** Yes. Values are case sensitive, so use one style, usually lower case, to keep your reports in one piece. **What if my address already has a query?** Your parameters are kept and the UTM ones are added after them. If it already had UTM parameters, they are replaced. **Where does the #fragment go?** At the very end of the link, after the parameters, as browsers expect. **Should I use UTM links inside my own website?** It is best not to. A tagged internal link can start a new visit in your analytics and hide where the visitor really came from. More: [HowToolbox index](https://how.box/llms.txt) · [Agent Skill](https://how.box/skill.md) · [agent terms](https://how.box/about/agents/)