Set optional message features

You can enable optional features in the Settings step in an In-App Automation, Scene, or Survey.

Campaign categories

Campaign categories are labels that group messages of a similar type or messaging strategy for aggregate reporting. Campaigns help you track the efficacy of both your individual messages and a messaging campaign as a whole.

Enter a campaign category name, then click Add. Click the X next to any category to remove it. Category names have a 64-character maximum. Enter up to ten.

When adding a category defined in message limits, the category will display the message limit rules with an option to override the limit for this send. Click the check box next to “Ignore limit for this message” to override the limit for this category.


Campaign categories are listed in the Message Detail section of Message Reports.

Choose message priority

Assign a priority to ensure that your audience sees the highest priority messages first.

Message priority determines the order in which messages appear to users; messages appear to the user in order from highest to lowest priority. Message priority is an integer between 1-100, where 1 is the highest priority, 100 the lowest. If a user receives two messages with the same priority, the more recently updated message appears first. Priority is shared across in-app automation, scenes, and surveys.

For example, you may have two messages configured to display on the next app open: an urgent account security warning, and a promotional marketing message. If you have assigned a high priority to the security warning and a lower priority to the marketing message, the higher priority message will appear first.

Use the slider to set rough priorities, or look at the number value to make fine distinctions.


Setting a priority is useful because multiple messages can become eligible for display at one time.


Setting message priority does not guarantee one message will display before another, because all other other conditions must be met for a message to become eligible for display. Priority is available as a tiebreaker when you have multiple messages ready for display.

Custom keys

Custom keys are additional key-value pairs in your push notification payload for use by custom code in your app. You can use custom keys to pass additional campaign identifiers for analytics, pass user information to the device, control the look and feel of the app, provide image links, etc.

This option appears in Settings for Scenes only and is not available for Surveys. For In-App Automation, configure custom keys in the Content step.

Enter a key and value. Click Add another for additional keys.

Override default missed behavior action

Override the project-level setting, specifying how the message is handled when audience conditions are not fully met. Select one of:

  • Cancel: The message cannot be displayed again on the device, even if the message is edited.

  • Ignore: The message will not count toward the display limit set in Repeat this message, and the waiting period will not apply. The trigger event must occur again before the message is eligible for redisplay.

  • Increment: The message will count toward the display limit set in Repeat this message, and the waiting period will apply. The trigger event must occur again before the message is eligible for redisplay.

Ignore channel message limits

Override the project-level Message LimitsLimits that cap the number of messages you can send within a specified time frame, preventing you from over-messaging your users. They are set at the project level. to ensure that your audience will receive your message even if they’ve reached the message limit.

You may want to override message limits for important information like breaking news, account alerts, or location proximity-based content.


This option is present only when one or more multiple-channel message limits are set.

Repeat this message

Configure the maximum number of times a message may be displayed and the minimum waiting period before it is eligible for redisplay.

Enter the maximum number of times the message may be displayed, then enter the minimum number of minutes, hours, or days that must elapse before a message becomes eligible for redisplay.



Use this option if you want your message to be eligible to be repeated (redisplayed) to your users. Redisplaying your message is useful because users can dismiss or ignore your messages.

Specify start and end dates

Set start and end dates and times during which your message can be displayed.

Click the date field and either use the date picker, or enter a date in YYYY-MM-DD format, then select the time and time zone.