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. You can add a maximum of ten categories.

Enter a campaign category name, then select Add. Category names have a 64-character maximum.

For categories defined in message limits, its limit displays after the category. To override the limit, select the check box for Ignore limit for this message.


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. Select 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

Determine whether the message can be repeated a limited or unlimited amount of times and the minimum waiting period before it is eligible for redisplay.

  1. Select Limited number of displays or Unlimited number of displays.
  2. (For limited displays only) Enter the maximum number of times the message should be displayed.
  3. Enter the minimum number of seconds, minutes, hours, or days that must elapse before a message becomes eligible for redisplay.

  • TriggersAn event that causes an in-app automation, scene, or survey to appear to your audience. are not monitored while a message is ineligible for display. The trigger event must occur again after the minimum time elapses before the message will redisplay.

    For example, if you set the maximum number of displays to 3 and the minimum time between displays to 1 week, the message will display a maximum of 3 times and at most once per week.

  • For Scenes only, you can override Repeat by selecting Dismiss and cancel Repeat when configuring a button’s scene behavior or when configuring the Submit Responses button action. See Button Group in Configure Scene content and Submit responses in Button Actions.

Specify start and end dates

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

Select a date, then select a time and time zone.