Push Notification Guide

Connect with your customers where they're at by creating dynamic and personalized push notifications.

Push notifications include title and content sections which can include text, emojis, and personalized content.

Creating a Push Notification

From your Dyspatch dashboard, or from a workspace folder, select Push from the Create dropdown menu.

Create new Push menu option

Select a workspace for your push notification, give it a name, and an optional description.

Create a push notification page with workspace, name, and description options

Include a Title, Content, and any Conditional Display rules in the push notification builder.

Push notification being built in the Push notification builder

Personalizing Push Notifications

Use DML Variables to include dynamic content to your push notifications. Include sample data on the Personalize tab, or use your organization's customer profiles. All DML variable key names are enclosed in @{}.

Push notification with dynamic DML variables, being previewed with dynamic data

Preview your personalized variables by toggling on Preview Dynamic Data from the Personalize tab.

Arrow pointing to the preview dynamic data tab in the push notification builder

View more on testing with preview data.

Creating Push Notification Conditionals

Create push notification variations and apply conditions to ensure the right customer receives the right notification.

Create a Push Notification Variant

To use conditional logic to display customized notifications, create a variant for each possible message a user could receive.

Select Create variant below the last variant in the list and modify the content.

Arrow  pointing to the create variant button in the push notification builder

Add a Conditional Display Rule for Each Push Variant

Select the Edit Conditional button next to a variant to bring up the conditional builder.

Select Add Logic and include the condition to display that variant when equated to true. In the following example, if the customer's data includes member_status and it is basic, they will be shown Variant 2.

Conditional example displaying variant 2 if member_status is equal to basic

A common practice is to include an else fallback to catch all remaining instances

Push Character Counts

Character counts let you know when your content is likely to be excluded from an expanded notification preview.

Notification title character count in the push notification builder

While character counts can be exceeded, that may result in content spilling outside of the customer's expanded notification.

Dynamic Variable lengths cannot be calculated. Be sure to test a variety of possible data sets

Localizing Push Notifications

Use the Localizations tab to add translations to push notifications.

Navigate to the Localizations tab in the push builder to create a new localization. Select a language and give the localization a name that your team will recognize. This name is for your reference only and can follow any naming convention that works for your team.

Create a localization modal with French selected

Select a locale from the list, click on the section of text you'd like to add translations for, and edit the content in the locale dropdown, working within the conditional statements of the content.

Adding locale of Spanish with es-ES language code, then clicking in to edit the translation content
Find more localization tips and learn how to integrate your account with Phrase, Smartling, or XTM translation services at the Localization menu

Include any external files, such as style or copy guides, to ensure everyone involved is using the same reference material.

Project Link modal

Collaborate with Comments

Working in teams is what it's all about! Get input from stakeholders to make your push notifications effective.

Anyone on your team can add comments at any time during the building process. Mention team members with the @ symbol, resolve comments, see comment history, and check approval state changes all from the Collaborate tab.

A comment on a push notification requesting an edit to a notification variable

Approval Process

Submit your push notification for feedback and approval from team members and stakeholders before publishing.

Submit a push notification modal with Comment and Assign Approvers options

Once submitted, your draft will be locked in the Submitted state. An organization admin or workspace owner will either reject the draft with feedback for changes, making it editable again, or approve the draft. Approved drafts are then locked Approved state.

Org admins and workspace owners are able to skip approval and publish

For more details on the approval process:

Export Push

Congratulations! Your push notification has been approved!

Click Export in the top right of the push builder for a list of templating languages to either Download or Copy your notification as. Upload the push notification code to your service of choice.

Download push modal with templating language options django, handlebars, jinja, liquid, and handlebars.java

search icon

Didn't find what you're looking for?

Ask our support team, we're here to help!

Contact Support