Objective
Link shortening replaces long links in your SMS, MMS, and WhatsApp messages with short links on your own branded domain, and tracks engagement on them. This article shows you how to attach a domain to a Messaging Service and configure it.
Product
Programmable Messaging
Environment
Twilio Console
Procedure
- In the Twilio Console, select Communications in the left sidebar.
- Select Messaging, then Services.
- Select the Messaging Service you want to configure, then open the Add-ons tab.
- On the Link shortening with click tracking card, select Manage.
- On the Link shortening page, under Organization and Domain:
- Organization shows the organization set for this account and is read-only.
- Choose your domain from the Domain list. Only verified domains appear here.
- The callout previews how your shortened link will look.
- Select Save. Twilio confirms with Selected domain configured successfully.
- Review the Validate DNS section. It lists the records your domain needs:
- To onboard a root domain: point the domain's A record to the three IP addresses shown, and only those three.
- To onboard a subdomain: use the CNAME value shown. Use the copy control beside each value to copy it into your DNS provider.
- After your DNS records are in place, select Validate. Twilio reports DNS validation successful or DNS validation failed with the reason.
- In the Domain configuration section, set the optional behaviors you want:
- Domain fallback URL, where to send someone if the shortened link can't be resolved.
- Click tracking callback URL, where Twilio reports click events.
- Disable "https://" prefix, show the short link without the scheme.
- Select Save changes. Twilio confirms with Domain configuration updated successfully.
Additional Information
- The Add-ons tab is available for Messaging Services in the regions that support it.
- Your account needs an organization and at least one verified domain before you can select a domain here. If either is missing, the add-on card offers Create an organization or Set up a domain instead of Manage.
- Without correct DNS configuration, shortened links will not redirect successfully, validate the records before you rely on the domain in production.
- Link shortening is part of Engagement Suite, which is billed at a premium per message.
- Once the domain is configured you also need a TLS certificate for it.
- To stop using the domain on this service, select the cancel option on the Organization and Domain form and confirm in the disable dialog.
- Select Back to all add ons to return to the Add-ons tab.
This content was generated by AI and reviewed, edited, and verified by a human.