Web Push Notification templates are reusable message blueprints that you can select in campaigns and journeys to send your users as web push notifications. They can contain contain text, links, and images, and you can customize them with user profile data, event data, data feeds, and Catalog data.
These messages can appear on desktop and mobile devices if your user has allowed them.
In this article
To create and edit templates, you'll need the Create and Manage Templates permission.
Creating a web push template
To create a web push notification template you can reuse for a single or multiple web push campaigns:
Go to Content > Templates.
Click New template > Web Push.
Give your template a name that will make it easy to find when you (or your teammates) are setting up campaigns or journeys. This field has a 150-character limit.
Click Create template.
There are other ways to create templates, too: as you're setting up a new campaign, and by using Iterable's API. For more info, read Working with Templates.
Configuring the details of push template
To update template details such as message type, title, body, icon etc., open it up and configure the options in the Details area.
To update these options, click Edit details. As you make changes, the template design (on the right side of the page) will update. When you're done editing, click Save or Cancel.
Below are descriptions of the settings in the Details area.
The category to associate with your template, which will affect who receives campaigns based on it. For more details, see Message Channels and Message and Message Types Overview.
The title that appears on the web push notification.
This is where your message goes! Make a connection with your users.
An image to include with your web push notification. The image's positioning depends on the operating system. HTTPS only. PNG files work best with web push, but you can also use JPG and GIF files. SVG files are not supported.
Data feeds allow you to fetch user-specific data from external URLs (your own or third-party) and use it to personalize your messages. For example, a restaurant chain might use a data feed to fetch information about locations close to the user, and then highlight them in their messages. To tell the data feed which user you need information for, you can pass query parameters in the data feed URL.
To enable data feeds, check Data feeds. Then, select an existing data feed from the dropdown or click Add a new data feed.
For more information about data feeds, related configuration options, and how to use them, read Personalizing Templates with Data Feeds.
The URL to load when a user taps the notification. HTTPS only.
Use locales to define the content this template uses for users in different locales. This feature doesn't translate for you, but provides a place for you to put localized content.
For more information, read Supporting Multiple Languages.
Previewing a web push template and sending test messages
After configuring and designing your template, preview it and make any necessary fixes. To check your template, use the Preview page or send a test message.
Previewing your template
To see what your web push notification will look like when rendered with different combinations of user data, data feeds, and Catalog data, use the Preview page. On this page, you can load a user profile and see how the template will render for that user.
Previewing a template for a specific user won't make any changes to your template. However, you can use the Details button (on the bottom-left corner of the page) to update your template's details.
To preview a web push notification template with user data:
With the template open, click Preview.
Enter the email address of a user in your project and click Load user data. That user's data will load.
Feel free to play around with this data, modifying it as needed — your changes won't get saved to the user profile. Treat this page as a playground, and check how different combinations of data will cause your template to render. Make sure that the template looks correct in all the different ways it may appear to your users.
If the preview doesn't update after you've edited or loaded data, click the refresh icon (at the top-right corner of the previewer).
To see how your template will render with a data feed loaded, click Load data feeds. Feel free to edit the loaded data feed data, to see how different data will look. This won't affect the data feed itself.
Click Exit preview to return to the template page.
For more information on previewing templates and campaign templates with data, check out Previewing with Data.
Sending a test message
Test messages allow you to validate your setup and experience this template from a customer's perspective.
You can send a test message to any of the options in the dropdown to see how your message works live, and check for any issues in the configuration.
Message recipients are capped at 50, to prevent accidentally sending test messages to a production list.
For more information, read Sending Test Messages.
The user receiving a test message must have a
browserTokens array associated
with their profile.
Sending a web push campaign
You've built and tested your template. Now, you can use it with some campaigns. To learn how, read:
- Sending or Scheduling a Blast Campaign
- Activating a Triggered Campaign
- Tutorial: Build Your First Journey
As you create a campaign (whether standalone as part of a journey), you select a template to use as the starting point as the campaign's content. The campaign you just created will get its own copy of the template, so you can customize it however you like without affecting the original template.
Similarly, if you change a template that you've already used in a campaign, your changes will only affect the template itself, not existing campaigns that use the original template.
To apply template changes to a campaign you've already created, you can manually make the same changes to the campaign's template, create a new campaign using the updated template, or reselect the updated template for the unsent campaign.