One way to ensure that your template is set up correctly is to send test messages (proofs) to yourself and other people.
In this article
Sending a test message (proof)
When editing a template or campaign content, send a test message by clicking Send proof or Send test message.
This button provides four options:
To yourself - Sends a test message to you (the user who is currently logged in to Iterable), using data from your Iterable profile to resolve any Handlebars expressions.
To an internal list - Sends test messages to the users in the internal list you select.
As random users - Sends test messages to you, the member currently logged in to Iterable, using data from random users from a list you select. This field accepts
email
anduserId
entries in hybrid and userID-based projects.To another address - Sends a test message to email addresses or userIds that you specify.
userId
is accepted in userID-based and hybrid projects, but not email-based projects.
To select from a list of previous recipients, click into the Recipients field.
Test message user field requirements
Make sure your test message recipients are set up to receive messages on the medium you're sending (email, push, in-app, web push, or SMS).
Message medium | Required user setup |
---|---|
SMS | The user has a phoneNumber field on their user profile. |
Push and in-app | The app is installed on the user's device, as indicated by the devices array with active devices. |
Web push | The user has consented to receive web push notifications, as indicated by the browserTokens array on the user profile. |
The user has an emailAddress field on their user profile. |
Things to note
Merge parameters such as
{{viewInBrowserUrl}}
and{{unsubscribeUrl}}
, which produce links, do not behave in test messages as they do in campaigns.When sending test messages from the Preview page, Iterable uses the loaded user data when sending the test message, including any manual edits you have made. This allows you to modify the data and send test messages to preview how it will look in a live campaign.
In-app message and push notification test messages ignore Selective In-App or Selective Push settings (unless they're sent while creating or editing a campaign).