Button actions in the WYSIWYG editor

Associate actions with the buttons and images in your messages.

When using the WYSIWYG editor for Rich PagesA landing page or Message Center message in your app that can include HTML, video, etc. and In-App AutomationMessages that are cached on users’ devices and displayed when your users meet certain conditions within your app, such as viewing a particular screen or opening the app a certain number of times. , you can assign an ActionA configurable behavior that occurs when a user interacts with your message, e.g., opening a web page. that occurs when a user taps the buttons and images in the message. You can also use HandlebarsHandlebars is Airship’s templating language for personalization. Handlebars expressions use double curly braces wrapped around a content template, ranging from a simple variable, e.g., {{first_name}}, to complex evaluations of personalization data. to personalize the actions. Minimum SDKs required to support all actions: iOS 8.5.0, Android 9.0.0.

Select the Button or Image element in your message, then configure Action in the sidebar. Select one of:

  • No Action
  • Adaptive Link
  • App Rating
  • Deep Link
  • Dismiss Message — In-app automation only
  • Preference Center
  • Push Opt-in — In-app automation only
  • Share
  • Web Page

By default, the total clicks for all buttons and images in the message are reported using Custom EventEvents that indicate that a user performed a predefined action, such as adding an item to a shopping cart, viewing a screen, or clicking an Unsubscribe button. Custom events can trigger automation, sequences, scenes, and surveys. You can code them into your app or website, or send them to Airship from an external source using the custom event API. Custom events contain properties that you can use to personalize messages. ua_button_tap.

To differentiate the clicks for a specific button, enter an Event Name. This name is appended to the default. For instance, if you enter Cat socks55, the event name in reporting will be ua_button_tap-Cat socks55.

Event names also support HandlebarsHandlebars is Airship’s templating language for personalization. Handlebars expressions use double curly braces wrapped around a content template, ranging from a simple variable, e.g., {{first_name}}, to complex evaluations of personalization data. .


If the button or image is used in a landing page, check the Landing page behavior box if you want the landing page to close after the selected action occurs. When the user reopens your app, the landing page will no longer be open. Minimum SDKs required: iOS 14.2.0, Android 14.1.0.


You can also add or remove tags when a user taps the notification:

  1. Click Configure options.
  2. Select Add or Remove, then search for tags that exist in the system or create a new tag.

Click Configure another option to add more tags.