Custom Notification Buttons Tutorial

Create custom notification buttons that prompt a user to take specific actions within or outside of your app.

Airship has 30+ out-of-the-box buttons to match the most common use cases that we have identified, but you can also create custom buttons.

 Important

Interactive notification buttons are tied to an action within your app, so a developer must first update your app, registering new categories in the Airship SDK.

After your developer registers the new categories, you can complete this tutorial. You will need the category name for each button.

In this tutorial, you will:

  1. Name a new button and enter its category.
  2. Specify the button's label and actions.
  3. Optionally create a secondary button.
  4. Save the button for use.

Enable Notification Buttons

  1. Open your messaging project and go to Settings » Configuration » Feature Settings.
  2. Toggle Notification Buttons to ON.

Create a New Notification Button

  1. Open your messaging project and go to Settings » Configuration » Feature Settings.
  2. Click New Notification Buttons.
  3. Enter a Name and Description for the button, so you can identify it.
  4. Enter the Category Name that is passed to the mobile device to identify which notification buttons to display with a message.
  5. (Optional) Clear the Enabled box if you do not yet want these buttons to appear in the list of buttons when composing messages.
  6. Specify the label and actions for each button. You must configure at least one.
    • Button Label: Identifies button label for display purposes in the dashboard. Should match the label defined in the app. Does NOT change button labels in app.
    • ID: Associates actions with the correct button label when passed by message.
    • Foreground or Background: Controls which actions are available in the dashboard. Must match button ID defined in the app.
    • Destructive: Indicates if button action causes the removal of data, features, etc. Appears red on iOS. Must match capability defined in the app. Check the box to enable.
  7. Click Save.

Include a Button in a Message

After you create a button, you can add it to a Message, A/B Test, Automation, or Push Template.

In Optional Features in the Content step, toggle Buttons to ON, then click Select buttons and search for your custom buttons.