Track SMS campaigns with URL parameters: add comet_source=sms to your text message links to see the visits, leads and sales each campaign brings.
To track SMS campaigns with URL parameters, you add a short tag, comet_source=sms, to the end of every link in your text messages. When someone taps the link, the tag tells Cometly the visit came from SMS.This lets you report on SMS as its own source, next to your ads and email. Add a campaign or message tag as well, and you can see which text message or broadcast produced each lead and sale.
Add the Cometly SMS parameter
Append the following URL parameter to every link in the SMS messages you send:
?comet_source=sms
You can also copy the parameter in Cometly: go to Setup, open step 4 Add URL parameters to your ads, choose SMS in the Select integration dropdown and click Copy Parameters.
Example: if your SMS contains this link:https://www.cometly.com/demoappend the URL parameter like so:https://www.cometly.com/demo?comet_source=sms
Add the parameter to each new text message you send, not only the ones you have today.Using Klaviyo? You can have it add the parameter for you. See Email and SMS tracking with Klaviyo.
Track specific SMS campaigns and messages
For more granular SMS reporting, add more URL parameters to identify the specific SMS or the SMS broadcast or campaign, such as:
utm_campaign
utm_content
Example: if your SMS contains this link:https://www.cometly.com/demoappend the URL parameters like so:https://www.cometly.com/demo?comet_source=sms&utm_campaign=smscampaign1&utm_content=sms1
SMS reporting
To report on your SMS campaigns, open the Report Builder and select the SMS source under Sources.If you added the extra URL parameters shown above, you can report on specific campaigns or SMS messages with the URL Parameters filter in the Report Builder.
Check it worked
Once people tap your tagged links, open the Report Builder and select the SMS source. Those visits, and the conversions that follow them, are reported under SMS.
Frequently asked questions
What if my SMS link already has a question mark in it?
Then the link already has parameters, so start the Cometly parameter with & instead of ?. For example, www.test.com?variant=123456 becomes www.test.com?variant=123456&comet_source=sms. See URLs that already have parameters.
Does Cometly track SMS clicks without the URL parameter?
Not as SMS. A tap on a link in a text message usually arrives without a referring URL, and Cometly reports visits without one as Direct / None. Add comet_source=sms to the link so the visit counts toward the SMS source. See Referral vs. direct traffic sources.
Do I need the Cometly pixel on the page my SMS links to?
Yes. The Cometly pixel (the tracking script on your website) is what records each visit and where it came from, so it must be installed on the page the link opens. See Install and verify the Cometly pixel.
Still have questions or need a hand? We’re happy to help. Reach our team at support@cometly.com.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cometly Docs","description":"Cometly documentation: set up ad tracking and attribution, connect your ad platforms and tools, send conversions back with the Conversion API, and build on the Cometly API and MCP server.","colors":{"primary":"#0086FF","light":"#0086FF","dark":"#0086FF"},"logo":{"light":"https://mintcdn.com/cometly/hnuCBvleNSBDJAON/logo/light.svg?fit=max\u0026auto=format\u0026n=hnuCBvleNSBDJAON\u0026q=85\u0026s=1b725e99cd933554c9ab680583d1b779","dark":"https://mintcdn.com/cometly/hnuCBvleNSBDJAON/logo/dark.svg?fit=max\u0026auto=format\u0026n=hnuCBvleNSBDJAON\u0026q=85\u0026s=5b27a31c96508945608d23fa3394eafc"},"favicon":"https://mintcdn.com/cometly/hnuCBvleNSBDJAON/favicon.svg?fit=max\u0026auto=format\u0026n=hnuCBvleNSBDJAON\u0026q=85\u0026s=676feb9017410d273527df10995ef763","api":{"playground":{},"mdx":{"auth":{"method":"bearer"},"server":"https://app.cometly.com"}},"navbar":{"links":[{"href":"mailto:support@cometly.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.cometly.com"}},"seo":{"metatags":{"og:site_name":"Cometly Docs","og:locale":"en_US","twitter:card":"summary_large_image"},"indexing":"navigable"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cometly","hasAudioNarration":false,"actualSubdomain":"cometly","customDomains":["docs.cometly.com"],"gitSource":{"type":"github","owner":"cometly","repo":"app","deployBranch":"main","contentDirectory":"publicApiDocs/V1","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afe1ed3e5481c801f76013c","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"Integrations","count":137},{"language":"default","tag":"Guides","count":70},{"language":"default","tag":"Integrations by platform","count":68},{"language":"default","tag":"MCP","count":58},{"language":"default","tag":"Troubleshooting","count":50},{"language":"default","tag":"Tools","count":49},{"language":"default","tag":"Developers \u0026 API","count":44},{"language":"default","tag":"Getting Started","count":38},{"language":"default","tag":"Settings","count":23},{"language":"default","tag":"Events","count":22}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@cometly.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".card-group .card{transition:background-color 150ms ease, border-color 150ms ease}.card-group .card:hover{background-color:#f6f7f8!important}.dark .card-group .card:hover{background-color:rgba(255, 255, 255, 0.04)!important}.start-cards .card-group .card{position:relative;isolation:isolate;background-color:#ffffff!important;background-image:radial-gradient(110% 60% at 50% 115%, rgba(0, 134, 255, 0.05) 0%, transparent 70%),\n linear-gradient(180deg, #ffffff 0%, #f6f7f9 100%)!important;border-color:#e4e7ec!important;box-shadow:0 1px 2px rgba(16, 24, 40, 0.04);transition:border-color 200ms ease, box-shadow 200ms ease, transform 200ms ease}.start-cards .card-group .card::before{content:\"\";position:absolute;inset:auto 0 0 0;height:85%;z-index:-1;pointer-events:none;background-image:repeating-linear-gradient(90deg, rgba(100, 116, 139, 0.15) 0, rgba(100, 116, 139, 0.15) 1px, transparent 1px, transparent 26px),\n repeating-linear-gradient(90deg, transparent 0, transparent 13px, rgba(100, 116, 139, 0.08) 13px, rgba(100, 116, 139, 0.08) 14px, transparent 14px, transparent 26px);-webkit-mask-image:linear-gradient(to top, #000 0%, transparent 90%);mask-image:linear-gradient(to top, #000 0%, transparent 90%);opacity:0.8;transition:opacity 200ms ease}.start-cards .card-group .card:hover{background-color:#ffffff!important;border-color:rgba(0, 134, 255, 0.45)!important;box-shadow:0 12px 28px -16px rgba(0, 134, 255, 0.35), 0 1px 2px rgba(16, 24, 40, 0.05);transform:translateY(-1px)}.start-cards .card-group .card:hover::before{opacity:1}.start-cards [data-component-part=\"card-image\"]{display:block;width:100%;height:auto;margin:0!important;border-bottom:1px solid #eceef2}.start-cards [data-component-part=\"card-icon\"]{display:flex;align-items:center;justify-content:center;width:2.5rem!important;height:2.5rem!important;border-radius:0.75rem;background:linear-gradient(135deg, #46a9ff 0%, #0086ff 55%, #0068d6 100%);box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.35), 0 6px 14px -6px rgba(0, 134, 255, 0.65)}.start-cards [data-component-part=\"card-icon\"]>svg{width:1.25rem!important;height:1.25rem!important;background-color:#ffffff!important}.dark .start-cards .card-group .card,.dark .start-cards .card-group .card:hover{background-color:rgba(255, 255, 255, 0.02)!important;background-image:radial-gradient(110% 60% at 50% 115%, rgba(0, 134, 255, 0.14) 0%, transparent 70%)!important;border-color:rgba(255, 255, 255, 0.12)!important}.dark .start-cards .card-group .card:hover{border-color:rgba(70, 169, 255, 0.6)!important}.dark .start-cards .card-group .card::before{background-image:repeating-linear-gradient(90deg, rgba(148, 163, 184, 0.2) 0, rgba(148, 163, 184, 0.2) 1px, transparent 1px, transparent 26px),\n repeating-linear-gradient(90deg, transparent 0, transparent 13px, rgba(148, 163, 184, 0.1) 13px, rgba(148, 163, 184, 0.1) 14px, transparent 14px, transparent 26px)}.dark .start-cards [data-component-part=\"card-image\"]{border-bottom-color:rgba(255, 255, 255, 0.08)}.logo-tile{display:inline-flex;align-items:center;justify-content:center;flex:none;width:2.5rem;height:2.5rem;border-radius:0.75rem;border:1px solid #e5e7eb;background:#ffffff;overflow:hidden}.logo-tile img{width:1.375rem!important;height:1.375rem!important;max-width:none!important;margin:0!important;border-radius:0!important;object-fit:contain;pointer-events:none}.logo-tile-sm{width:2rem;height:2rem;border-radius:0.5rem}.logo-tile-sm img{width:1.125rem!important;height:1.125rem!important}.logo-tile-letter{font-size:0.8125rem;font-weight:600;color:#6b7280;background:#f9fafb}.dark .logo-tile{border-color:rgba(255, 255, 255, 0.12)}.logo-row{display:flex;flex-wrap:wrap;align-items:center;gap:0.5rem;margin-top:0.875rem}.logo-more{margin-left:0.25rem;font-size:0.8125rem;font-weight:500;color:#6b7280;white-space:nowrap}.dark .logo-more{color:#9ca3af}.integration-grid{display:grid;grid-template-columns:repeat(1, minmax(0, 1fr));gap:0.25rem 0.75rem;margin:1rem 0 0.5rem}@media (min-width: 640px){.integration-grid{grid-template-columns:repeat(2, minmax(0, 1fr))}}@media (min-width: 1024px){.integration-grid{grid-template-columns:repeat(3, minmax(0, 1fr))}}.integration-grid a{display:flex;align-items:center;gap:0.625rem;padding:0.375rem 0.5rem;border-radius:0.625rem;border:0!important;font-size:0.875rem;font-weight:500!important;line-height:1.3;color:inherit!important;text-decoration:none!important;transition:background-color 150ms ease}.integration-grid a:hover{background-color:#f6f7f8}.dark .integration-grid a:hover{background-color:rgba(255, 255, 255, 0.04)}.dark li>a img[src^=\"/images/logos/\"]{background:#ffffff!important;border-radius:0.25rem;padding:1px}"}],"page":{"pagePath":"guides/url-parameters/sms","slug":"/guides/url-parameters/sms","pageMetadata":{"title":"Track SMS campaigns with URL parameters","description":"Track SMS campaigns with URL parameters: add comet_source=sms to your text message links to see the visits, leads and sales each campaign brings.","og:title":"Track SMS Campaigns with URL Parameters in Cometly","href":"/guides/url-parameters/sms"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Track SMS campaigns with URL parameters: add comet_source=sms to your text message links to see the visits, leads and sales each campaign brings.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`To track SMS campaigns with URL parameters, you add a short tag, `,_jsx(_components.code,{children:`comet_source=sms`}),`, to the end of every link in your text messages. When someone taps the link, the tag tells Cometly the visit came from SMS.`]}),`\n`,_jsx(_components.p,{children:`This lets you report on SMS as its own source, next to your ads and email. Add a campaign or message tag as well, and you can see which text message or broadcast produced each lead and sale.`}),`\n`,_jsx(Heading,{level:`2`,id:`add-the-cometly-sms-parameter`,children:`Add the Cometly SMS parameter`}),`\n`,_jsx(_components.p,{children:`Append the following URL parameter to every link in the SMS messages you send:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`?comet_source=sms`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`You can also copy the parameter in Cometly: go to `,_jsx(_components.strong,{children:`Setup`}),`, open step 4 `,_jsx(_components.strong,{children:`Add URL parameters to your ads`}),`, choose `,_jsx(_components.strong,{children:`SMS`}),` in the `,_jsx(_components.strong,{children:`Select integration`}),` dropdown and click `,_jsx(_components.strong,{children:`Copy Parameters`}),`.`]}),`\n`,_jsxs(Tip,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Example:`}),` if your SMS contains this link:`]}),_jsx(_components.p,{children:_jsx(_components.code,{children:`https://www.cometly.com/demo`})}),_jsx(_components.p,{children:`append the URL parameter like so:`}),_jsx(_components.p,{children:_jsx(_components.code,{children:`https://www.cometly.com/demo?comet_source=sms`})})]}),`\n`,_jsx(_components.p,{children:`Add the parameter to each new text message you send, not only the ones you have today.`}),`\n`,_jsxs(_components.p,{children:[`Using Klaviyo? You can have it add the parameter for you. See `,_jsx(_components.a,{href:`/guides/url-parameters/klaviyo-email-and-sms`,children:`Email and SMS tracking with Klaviyo`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`track-specific-sms-campaigns-and-messages`,children:`Track specific SMS campaigns and messages`}),`\n`,_jsx(_components.p,{children:`For more granular SMS reporting, add more URL parameters to identify the specific SMS or the SMS broadcast or campaign, such as:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`utm_campaign`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`utm_content`})}),`\n`]}),`\n`,_jsxs(Tip,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Example:`}),` if your SMS contains this link:`]}),_jsx(_components.p,{children:_jsx(_components.code,{children:`https://www.cometly.com/demo`})}),_jsx(_components.p,{children:`append the URL parameters like so:`}),_jsx(_components.p,{children:_jsx(_components.code,{children:`https://www.cometly.com/demo?comet_source=sms\u0026utm_campaign=smscampaign1\u0026utm_content=sms1`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`sms-reporting`,children:`SMS reporting`}),`\n`,_jsxs(_components.p,{children:[`To report on your SMS campaigns, open the `,_jsx(_components.a,{href:`/guides/report-builder/build-a-report`,children:`Report Builder`}),` and select the `,_jsx(_components.strong,{children:`SMS`}),` source under `,_jsx(_components.strong,{children:`Sources`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`If you added the extra URL parameters shown above, you can report on specific campaigns or SMS messages with the `,_jsxs(_components.a,{href:`/guides/report-builder/url-vs-url-parameters-filters`,children:[_jsx(_components.strong,{children:`URL Parameters`}),` filter`]}),` in the Report Builder.`]}),`\n`,_jsx(Heading,{level:`2`,id:`check-it-worked`,children:`Check it worked`}),`\n`,_jsxs(_components.p,{children:[`Once people tap your tagged links, open the Report Builder and select the `,_jsx(_components.strong,{children:`SMS`}),` source. Those visits, and the conversions that follow them, are reported under `,_jsx(_components.strong,{children:`SMS`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`frequently-asked-questions`,children:`Frequently asked questions`}),`\n`,_jsx(Heading,{level:`3`,id:`what-if-my-sms-link-already-has-a-question-mark-in-it`,children:`What if my SMS link already has a question mark in it?`}),`\n`,_jsxs(_components.p,{children:[`Then the link already has parameters, so start the Cometly parameter with `,_jsx(_components.code,{children:`\u0026`}),` instead of `,_jsx(_components.code,{children:`?`}),`. For example, `,_jsx(_components.code,{children:`www.test.com?variant=123456`}),` becomes `,_jsx(_components.code,{children:`www.test.com?variant=123456\u0026comet_source=sms`}),`. See `,_jsx(_components.a,{href:`/guides/url-parameters/urls-with-variant-parameter`,children:`URLs that already have parameters`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`does-cometly-track-sms-clicks-without-the-url-parameter`,children:`Does Cometly track SMS clicks without the URL parameter?`}),`\n`,_jsxs(_components.p,{children:[`Not as SMS. A tap on a link in a text message usually arrives without a referring URL, and Cometly reports visits without one as `,_jsx(_components.strong,{children:`Direct / None`}),`. Add `,_jsx(_components.code,{children:`comet_source=sms`}),` to the link so the visit counts toward the SMS source. See `,_jsx(_components.a,{href:`/guides/analyzing-data/referral-vs-direct`,children:`Referral vs. direct traffic sources`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`do-i-need-the-cometly-pixel-on-the-page-my-sms-links-to`,children:`Do I need the Cometly pixel on the page my SMS links to?`}),`\n`,_jsxs(_components.p,{children:[`Yes. The Cometly pixel (the tracking script on your website) is what records each visit and where it came from, so it must be installed on the page the link opens. See `,_jsx(_components.a,{href:`/getting-started/install-pixel`,children:`Install and verify the Cometly pixel`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next steps`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/guides/url-parameters/klaviyo-email-and-sms`,children:`Add the SMS parameter automatically with Klaviyo`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/guides/report-builder/build-a-report`,children:`Build a report in the Report Builder`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/guides/report-builder/url-vs-url-parameters-filters`,children:`Filter reports by URL parameters`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/guides/url-parameters/email`,children:`Track email campaigns with URL parameters`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/getting-started/url-parameters`,children:`Set up URL parameters for all channels`})}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Still have questions or need a hand? We’re happy to help. Reach our team at `,_jsx(_components.a,{href:`mailto:support@cometly.com`,children:`support@cometly.com`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Track SMS campaigns with URL parameters","description":"Track SMS campaigns with URL parameters: add comet_source=sms to your text message links to see the visits, leads and sales each campaign brings.","og:title":"Track SMS Campaigns with URL Parameters in Cometly","href":"/guides/url-parameters/sms"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Add the Cometly SMS parameter","slug":"add-the-cometly-sms-parameter","depth":2,"children":[]},{"title":"Track specific SMS campaigns and messages","slug":"track-specific-sms-campaigns-and-messages","depth":2,"children":[]},{"title":"SMS reporting","slug":"sms-reporting","depth":2,"children":[]},{"title":"Check it worked","slug":"check-it-worked","depth":2,"children":[]},{"title":"Frequently asked questions","slug":"frequently-asked-questions","depth":2,"children":[{"title":"What if my SMS link already has a question mark in it?","slug":"what-if-my-sms-link-already-has-a-question-mark-in-it","depth":3,"children":[]},{"title":"Does Cometly track SMS clicks without the URL parameter?","slug":"does-cometly-track-sms-clicks-without-the-url-parameter","depth":3,"children":[]},{"title":"Do I need the Cometly pixel on the page my SMS links to?","slug":"do-i-need-the-cometly-pixel-on-the-page-my-sms-links-to","depth":3,"children":[]}]},{"title":"Next steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cometly/3e5ee102dead7316/cometly.js"],"subdomain":"cometly","siteName":"Cometly Docs","title":"Track SMS Campaigns with URL Parameters in Cometly","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T21:55:49.877Z","originalFileLocation":"guides/url-parameters/sms.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Track SMS campaigns with URL parameters: add comet_source=sms to your text message links to see the visits, leads and sales each campaign brings.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cometly Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cometly/gMocZlOJ0QUZ28NI/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cometly/gMocZlOJ0QUZ28NI/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cometly/gMocZlOJ0QUZ28NI/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cometly/gMocZlOJ0QUZ28NI/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cometly/gMocZlOJ0QUZ28NI/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cometly/gMocZlOJ0QUZ28NI/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cometly/gMocZlOJ0QUZ28NI/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cometly/gMocZlOJ0QUZ28NI/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cometly/gMocZlOJ0QUZ28NI/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Track SMS Campaigns with URL Parameters in Cometly\">\u003cmeta data-mint-head property=\"og:description\" content=\"Track SMS campaigns with URL parameters: add comet_source=sms to your text message links to see the visits, leads and sales each campaign brings.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cometly Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cometly.com/guides/url-parameters/sms\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cometly.mintlify.site/_mintlify/api/og/v2?division=URL+parameters\u0026amp;title=Track+SMS+campaigns+with+URL+parameters\u0026amp;description=Track+SMS+campaigns+with+URL+parameters%3A+add+comet_source%3Dsms+to+your+text+message+links+to+see+the+visits%2C+leads+and+sales+each+campaign+brings.\u0026amp;theme=4b81b0d192612debf11d7771\u0026amp;signature=6ad8efc74ca74b7d21645cb238b9d13fc8af0c24eaeef9ff2936c4e9021bb9b9\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Track SMS Campaigns with URL Parameters in Cometly\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Track SMS campaigns with URL parameters: add comet_source=sms to your text message links to see the visits, leads and sales each campaign brings.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cometly.mintlify.site/_mintlify/api/og/v2?division=URL+parameters\u0026amp;title=Track+SMS+campaigns+with+URL+parameters\u0026amp;description=Track+SMS+campaigns+with+URL+parameters%3A+add+comet_source%3Dsms+to+your+text+message+links+to+see+the+visits%2C+leads+and+sales+each+campaign+brings.\u0026amp;theme=4b81b0d192612debf11d7771\u0026amp;signature=6ad8efc74ca74b7d21645cb238b9d13fc8af0c24eaeef9ff2936c4e9021bb9b9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cometly/gMocZlOJ0QUZ28NI/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cometly Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0086FF\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cometly.com/guides/url-parameters/sms\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/url-parameters/sms.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cometly.com/#organization\",\"name\":\"Cometly Docs\",\"url\":\"https://docs.cometly.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cometly/hnuCBvleNSBDJAON/logo/light.svg?fit=max\u0026auto=format\u0026n=hnuCBvleNSBDJAON\u0026q=85\u0026s=1b725e99cd933554c9ab680583d1b779\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cometly.com#website\",\"name\":\"Cometly Docs\",\"url\":\"https://docs.cometly.com\",\"publisher\":{\"@id\":\"https://docs.cometly.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cometly.com/guides/url-parameters/sms#webpage\",\"url\":\"https://docs.cometly.com/guides/url-parameters/sms\",\"name\":\"Track SMS campaigns with URL parameters\",\"description\":\"Track SMS campaigns with URL parameters: add comet_source=sms to your text message links to see the visits, leads and sales each campaign brings.\",\"dateModified\":\"2026-11-18T21:55:49.877Z\",\"isPartOf\":{\"@id\":\"https://docs.cometly.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cometly.com/guides/url-parameters/sms#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cometly.com/guides/url-parameters/sms#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"URL parameters\",\"item\":\"https://docs.cometly.com/guides/url-parameters/custom-sources\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Track SMS campaigns with URL parameters\",\"item\":\"https://docs.cometly.com/guides/url-parameters/sms\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cometly.com/guides/url-parameters/sms#article\",\"headline\":\"Track SMS campaigns with URL parameters\",\"name\":\"Track SMS campaigns with URL parameters\",\"description\":\"Track SMS campaigns with URL parameters: add comet_source=sms to your text message links to see the visits, leads and sales each campaign brings.\",\"url\":\"https://docs.cometly.com/guides/url-parameters/sms\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cometly.com/guides/url-parameters/sms#webpage\"},\"dateModified\":\"2026-11-18T21:55:49.877Z\",\"publisher\":{\"@id\":\"https://docs.cometly.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cometly.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cometly Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cometly Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/guides/url-parameters/sms.md","siteName":"Cometly Docs","nav":{"global":null,"tabs":[{"tab":"Getting Started","icon":"rocket","pages":[{"title":"Getting Started","href":""}]},{"tab":"Guides","icon":"book-open","groups":[{"group":"Overview","pages":[{"title":"Guides","sidebarTitle":"Overview","href":"/guides/overview"}]},{"group":"Tracking and pixel","pages":[{"title":"Set up First Party Domain Tracking","href":"/guides/tracking/first-party-domain"},{"title":"Cross-domain tracking","href":"/guides/tracking/cross-domain-tracking"},{"title":"Cometly Pixel Helper (Chrome extension)","href":"/guides/tracking/pixel-helper"},{"title":"Pixel setup for SaaS companies","href":"/guides/tracking/pixel-setup-for-saas"},{"title":"Track only after consent","href":"/guides/tracking/consent"},{"title":"Exclude domains from the referrer source","href":"/guides/tracking/exclude-referral-domains"},{"title":"How Order ID works and when to use it","href":"/guides/tracking/order-id"},{"title":"Drop data-center traffic from your page views","href":"/guides/tracking/drop-data-center-traffic"},{"title":"Track sign-ups made with OAuth (Sign up with Google)","href":"/guides/tracking/oauth-signups"}]},{"group":"Form tracking","pages":[{"title":"Form tracking for third-party embedded forms","href":"/guides/form-tracking/third-party-forms"},{"title":"Test form tracking","href":"/guides/form-tracking/testing"}]},{"group":"Events","pages":[{"title":"How events work","href":"/guides/events/how-events-work"},{"title":"Manage custom events","href":"/guides/events/custom-events"},{"title":"Custom fields","href":"/guides/events/custom-fields"},{"title":"Edit or delete a conversion on a contact","href":"/guides/events/edit-or-delete-conversions"},{"title":"Set up Add to Cart and Initiate Checkout events","href":"/guides/events/add-to-cart-and-initiate-checkout"},{"title":"Set up call tracking","href":"/guides/events/call-tracking"}]},{"group":"URL parameters","pages":[{"title":"Custom URL parameter setup","href":"/guides/url-parameters/custom-sources"},{"title":"Track email campaigns with URL parameters","description":"Track email campaigns with URL parameters: add comet_source=email to your email links to see which emails drive leads and sales in Cometly.","href":"/guides/url-parameters/email"},{"title":"Track SMS campaigns with URL parameters","href":"/guides/url-parameters/sms"},{"title":"Meta catalog ads (dynamic website URL) URL parameters","description":"Add Cometly's Meta catalog ads URL parameters in the Tracking section of the ad, so clicks on products from your catalog feed are tracked.","href":"/guides/url-parameters/meta-catalog-ads"},{"title":"Apply URL parameters to a URL that contains a variant parameter","href":"/guides/url-parameters/urls-with-variant-parameter"},{"title":"Meta carousel ads URL parameter setup","href":"/guides/url-parameters/meta-carousel-ads"},{"title":"Email and SMS tracking with Klaviyo","href":"/guides/url-parameters/klaviyo-email-and-sms"},{"title":"URL parameter setup for Meta existing post ads","href":"/guides/url-parameters/meta-existing-post-ads"}]},{"group":"Conversion API","pages":[{"title":"How the Conversion API works","sidebarTitle":"Overview","href":"/guides/conversion-api/overview"},{"title":"Configure the Meta Conversion API","sidebarTitle":"Meta","href":"/guides/conversion-api/meta"},{"title":"Configure the Google Conversion API","sidebarTitle":"Google Ads","href":"/guides/conversion-api/google"},{"title":"Configure the TikTok Conversion API","sidebarTitle":"TikTok","href":"/guides/conversion-api/tiktok"},{"title":"Configure the LinkedIn Conversion API","sidebarTitle":"LinkedIn","href":"/guides/conversion-api/linkedin"},{"title":"Configure the Microsoft Ads Conversion API","sidebarTitle":"Microsoft Ads","href":"/guides/conversion-api/microsoft"},{"title":"Configure the Reddit Conversion API","sidebarTitle":"Reddit","href":"/guides/conversion-api/reddit"},{"title":"Configure the X Ads Conversion API","sidebarTitle":"X Ads","href":"/guides/conversion-api/x"},{"title":"Configure the Taboola Conversion API","sidebarTitle":"Taboola","href":"/guides/conversion-api/taboola"},{"title":"Configure the AdRoll Conversion API","sidebarTitle":"AdRoll","href":"/guides/conversion-api/ad-roll"},{"title":"Configure the ChatGPT Ads Conversion API","sidebarTitle":"ChatGPT Ads","href":"/guides/conversion-api/chatgpt-ads"},{"title":"Configure the AppLovin Conversion API","sidebarTitle":"AppLovin","href":"/guides/conversion-api/applovin"},{"title":"Event source URL for the Meta Conversion API","sidebarTitle":"Meta event source URL","href":"/guides/conversion-api/meta-event-source-url"},{"title":"Exclude an event from the Conversion API (consent, GPC and CCPA)","sidebarTitle":"Exclude an event","href":"/guides/conversion-api/exclude-an-event"}]},{"group":"Ads Manager","pages":[{"title":"Use the Ads Manager","href":"/guides/ads-manager/overview"},{"title":"Exclude an ad campaign from tracking","href":"/guides/ads-manager/exclude-a-campaign"},{"title":"Use filters in the Ads Manager","href":"/guides/ads-manager/filters"}]},{"group":"Report Builder","pages":[{"title":"Report Builder 101","href":"/guides/report-builder/overview"},{"title":"Build a report","href":"/guides/report-builder/build-a-report"},{"title":"Create grouped reports (Group By)","href":"/guides/report-builder/grouped-reports"},{"title":"Keyword reports for Google Ads and Microsoft Ads","href":"/guides/report-builder/keyword-reports"},{"title":"Analyze metrics month over month","href":"/guides/report-builder/month-over-month"},{"title":"Build an off-page SEO report","href":"/guides/report-builder/off-page-seo-report"},{"title":"Track affiliate conversions","href":"/guides/report-builder/affiliate-conversions"},{"title":"Track custom parameters","href":"/guides/report-builder/custom-parameters"},{"title":"New vs. returning events","href":"/guides/report-builder/new-vs-returning-events"},{"title":"Sources report","href":"/guides/report-builder/sources-report"},{"title":"Totals report","href":"/guides/report-builder/totals-report"},{"title":"URL vs. URL Parameters filters","href":"/guides/report-builder/url-vs-url-parameters-filters"}]},{"group":"Dashboards","pages":[{"title":"Customize your dashboards","href":"/guides/dashboards/customize"},{"title":"Build a cohort analysis dashboard","href":"/guides/dashboards/cohort-analysis"},{"title":"Calculate the time between contact creation and an event","href":"/guides/dashboards/time-between-profile-creation-and-event"},{"title":"Duplicate dashboards across spaces","href":"/guides/dashboards/duplicate-across-spaces"},{"title":"Use Quick Filters on dashboards","href":"/guides/dashboards/quick-filters"}]},{"group":"Agent","pages":[{"title":"Use the Agent","href":"/guides/agent/overview"},{"title":"Agent prompt library","href":"/guides/agent/prompt-library"},{"title":"Best practices for custom instructions","href":"/guides/agent/custom-instructions"}]},{"group":"Analyzing data","pages":[{"title":"Attribution models and attribution windows","href":"/guides/analyzing-data/attribution-models-and-windows"},{"title":"Metrics glossary","href":"/guides/analyzing-data/metrics-glossary"},{"title":"Data maturing","href":"/guides/analyzing-data/data-maturing"},{"title":"Export and analyze Cometly data","href":"/guides/analyzing-data/export-data"},{"title":"Create and use custom metrics","href":"/guides/analyzing-data/custom-metrics"},{"title":"Recommended naming conventions for paid ad campaigns","href":"/guides/analyzing-data/naming-conventions"},{"title":"Referral vs. direct traffic sources","href":"/guides/analyzing-data/referral-vs-direct"}]}]},{"tab":"Integrations","icon":"plug","pages":[{"title":"Integrations","href":"/integrations/overview"}]},{"tab":"Troubleshooting","icon":"wrench","pages":[{"title":"Troubleshooting","href":"/support/troubleshooting/overview"}]},{"tab":"Developers \u0026 API","icon":"code","pages":[{"title":"Developers \u0026 API","href":"/api-reference/overview"}]},{"tab":"MCP","icon":"robot","pages":[{"title":"MCP","href":"/mcp/overview"}]},{"tab":"Help \u0026 Support","icon":"headset","pages":[{"title":"Help \u0026 Support","href":"/support/contact"}]}]},"basePath":"","title":"Track SMS Campaigns with URL Parameters in Cometly","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":[],"chunks":[]}