SMS Template
Engage Premier End of Life
Engage Premier features, including Channels, Broadcasts, content templates, and Subscriptions, will no longer be available after December 15, 2025.
Use Twilio Engage to build SMS message templates to include throughout your marketing campaigns.
You can build an SMS template and include personalized content in messages based on user profile traits. Once you build the SMS, Twilio Engage saves the template for you to preview, maintain, and reuse.
Use personalized SMS messages to connect with users in real-time, as they reach a specific step in a journey.
You can choose between two SMS template types:
- Media, which contains media and text content
- Text, which contains text content of up to 1600 characters
Info
You must first configure your SMS service with Twilio to build an SMS template in Engage. Visit the onboarding steps for more on how to connect a Twilio account.
Follow these steps to build an SMS template:
- Navigate to Engage > Content and click Create template.
- Select SMS, then click Configure.
- Enter a template name and select your template's language.
- Select your template's content type, then click Next.
- For text templates, enter your message's text in the Body field and add any desired merge tags.
- For media templates, enter your message's text in the Body field, add the media URL, then add any desired merge tags. Media templates support PNG, JPEG, and GIF files.
- Include an opt-out message in the body of your text. For example, "Reply STOP to unsubscribe." See SMS Best Practices for more information.
- Once you've finished adding your template's content, click Save.
- Segment confirms that your template was saved.
Use the SMS Templates screen to preview and update existing SMS message templates.
Engage content validation
For all content editors in Engage, you'll see alerts for any issues in your template, such as invalid profile traits or incorrect liquid syntax. Engage both flags template issue(s), and displays recommended next steps. While you can save these templates, you must fix any issues before using them in Engage campaigns.
Send a test SMS message before you include it as a step in your Journey.
- After you build your SMS template, click Test SMS.
- If your template has profile traits, enter a trait value for the test SMS. This ensures that your merge tags work as expected.
- Empty fields show the default value that you've assigned. For example,
loyal customerwould be the default for the following merge tag:{{profile.traits.first_name | default: "loyal customer"}}. If there's no default value, the field will be blank.
- Empty fields show the default value that you've assigned. For example,
- Enter recipient phone numbers for the test message.
- Profiles that you send test messages to must have a userId in Segment.
- Click Send test SMS.
Success!
You can also test SMS templates directly within Journeys before you send them.
Use Link Shortening to send shorter, more manageable link URLs in your Engage SMS campaigns.
Configure Link Shortening in your Twilio Console in six steps:
- Set up an Organization
- Register Domains
- Add Domain Name System (DNS) records
- Generate a TLS certificate
- Upload your TLS certificate
- Configure fallback and callback URLs (Optional)
Once you've configured Link Shortening, Twilio automatically shortens the link URLs for recipients of your SMS messages. Link shortening occurs during the message sending process, so shortened links don't appear in the message editor.
Info
Link Shortening is only available for SMS messages.
You can edit, duplicate, and delete SMS templates within your Engage workspace.
To edit an SMS template:
- Navigate to Engage > Content.
- Select the ... icon next to template you want to edit. Click Edit.
- From the template's overview page, select Edit or Settings.
- Edit your template, then click Update Template to save your changes.
To duplicate an SMS template:
- Navigate to Engage > Content.
- Select the ... icon next to template you want to duplicate. Click Duplicate.
- From the Duplicate Template popup, click Duplicate.
After you duplicate a template, you can edit it from the Templates page.
To delete an SMS template:
- Navigate to Engage > Content.
- Select the ... icon next to template you want to delete. Click Delete.
- From the Confirm Template Deletion popup, click Delete Template.
When you build an SMS, include an opt-out message in the body of your text that informs recipients they can unsubscribe from a message channel.
When an SMS recipient replies "Stop" to an SMS, they'll receive an opt-out confirmation, and Engage updates their phone number subscription status. Visit the User Subscription States documentation to learn more about user subscriptions in Engage.
Note that there's a 1,600 character count limit for SMS messages. Visit Twilio's SMS Character Limit documentation for more information.
Use the Templates screen in Twilio Engage to build personalized email templates.