Admin Guide

Message Templates

A template is a ready-made set of notification fields (title, body, URL, image, buttons, tag) that can be reused multiple times when creating messages. Templates speed up the marketer's workflow and ensure content consistency across recurring campaigns.

Why templates

If you regularly send notifications of the same type โ€” for example, "New sale", "Order placed", "Cart reminder" โ€” create a template for each type. When creating a new message, select the template and all fields will be filled in automatically. This eliminates typos and saves time.

๐Ÿ›’
Abandoned cart

Template with a dynamic URL to a specific user's cart.

๐Ÿ“ฆ
Order status

"Your order has shipped" template with a tracking link.

๐Ÿ”ฅ
Weekly sale

A recurring promo template โ€” you only change the URL each time.

๐ŸŽ‰
Personal offers

Template with a variable in the URL for segmented campaigns.

Template fields

A template contains the same fields as a regular notification, plus the Name field for identification in the system.

FieldRequiredDescription
NameYesInternal name of the template โ€” visible only in the admin. Use clear names: "Sale banner", "Cart reminder".
TitleYesPush notification title. Recommended up to 60 characters.
BodyYesNotification body. Recommended up to 120 characters.
URLNoPage opened when clicked. Supports variables.
ImageNoNotification image URL. Recommended size 1080ร—565 px.
ButtonsNoUp to 2 action buttons under the notification (text up to 40 characters + link). Template variables work in both. Shown in Chrome, Edge and Android; Safari and Firefox show the notification without them.
TagNoMessage category (slug, e.g. orders or promo). Not shown to the user โ€” used to filter the message feed, a user's message history and unread counters.

Template variables

Any text field of a template can use dynamic variables. They are substituted at send time, so one template works for different campaigns.

{{ tag.KEY }}
User tag

Value of the recipient's tag KEY. Example: a link to the product the user viewed.

{{ user.externalId }}
External ID

The recipient's ID in your system. Example: a personal link to the user's account page.

{{ tag.KEY | default: "โ€ฆ" }}
Default value

Used when the tag or external ID is empty, so the link or text never ends up blank.

text
// Example URL field in a template:
https://example.com/cart?user={{ user.externalId }}&item={{ tag.last_cart_item | default: "none" }}

// Result for user user-42 with tag last_cart_item = "sku-1001":
https://example.com/cart?user=user-42&item=sku-1001

// Result for a user without the tag:
https://example.com/cart?user=user-7&item=none
๐Ÿ’ก
Variables in {{ ... }} work in the title, body, URL, image and buttons. The Tag field is copied as is. Campaign values (title, send date, message ID) can be added to links only through the UTM settings: Settings โ†’ Configuration โ†’ UTM.

Creating and editing

1
Go to Message Templates and click "New template".
2
Set the Name โ€” it is only visible in the admin interface and helps find the template in the list.
3
Fill in the notification fields. Use variables where you need dynamic content.
4
Click "Create template". The template is immediately available when creating messages.
โ„น๏ธ
Editing a template does not change already sent messages โ€” only new ones created based on it.

How to use a template when creating a message

1
Go to Messages โ†’ Create message.
2
In the "Notification content" block, switch the source to "From template".
3
Select the template from the dropdown list. The Title, Body, URL, Image, Buttons, Tag fields will be filled automatically.
4
Configure the audience and send mode, then click "Save and send".

Deleting a template

Delete a template via the action button in the table. This does not affect already created messages โ€” their content was copied from the template at the moment of selection.

โš ๏ธ
Deletion is irreversible. If the template is used in regular campaigns, make sure you have a backup copy or an up-to-date duplicate.

Related sections

โ†’ Messages

Templates are selected when creating a message. One template can be used for an unlimited number of campaigns.