Templates

OneSignal Reusable Push Notification, SMS, and Email Templates

Templates are reusable designs for push notifications, emails, and SMS. They do support liquid syntax for Message Personalization. Navigate to Messages > Templates to find the list of templates you have created, and basic statistics on their performance.

Templates can be created, viewed and deleted through the OneSignal dashboard or using the Create template, View templates, and Delete template APIs.

1722

Image showing list of templates

Create Templates

To create a new template, click New Template and select the channel-type from the dropdown. This brings you to a page identical to the Sending Message Create Form, but instead of sending a message, you are creating a reusable template.

Templates may also be created by duplicating templates from the Templates page:

1722

Image showing actions on templates

Sending Messages using Templates

Once you've created a template, to send it using that template click the Options button and click New Message.

284

Image showing ability to create new template

This will pre-populate the template options you've set into a new message. You can override these options (such as changing text, an icon, etc) when creating a message, by simply filling in different options. For details on these options, see:

Template Stats

Whenever you send a message with a template, its overall performance is tracked by OneSignal in the Templates page of your Dashboard.

Best practice is to have different templates for each use case so you can monitor how well your template campaigns are converting.

1748

Image showing templates with sent, opened and clicked stats

ColumnDetails
NameName of the template.
TypePush, Email, or SMS.
SentThe number of subscriptions in which this template was delivered. For example, if you send the template once but target 793 subscriptions, it will show 793.
OpenedPush: The unique number of times the push was clicked leading to app open.
Email: The total number of times the email was opened.
SMS: Not Applicable.
ClickedPush: Not Applicable.
Email: The total number of times a link in the email was clicked.
SMS: Not Applicable.
Conversion(Opened / Sent) x 100%

FAQ

Where is the template id?

The template_id is taken from the URL of the template when editing it. It is in the standard UUID format.

In this case, the template_id is de6cd3b0-b835-43e7-b554-acdae9e824e5.

2118

Image showing how to find your app id from the URL