Rich Content Editor Tutorial

The Rich Content Editor is used to create Rich Pages, which can include HTML, video, etc.

The Rich Content Editor is used to create Rich Pages. Rich Pages include HTML, video, etc., and are created as part of message creation in the Message, Automation, A/B Test composers.

Rich Pages are used with the Action types Landing Page and Message Center, however Message Center is not available in A/B Tests. See: Actions: Rich Pages.

The process for creating Rich Pages is nearly identical for Landing Page and Message Center, with only slight variations in the composer. Some differences include:

  • Only Message Center messages support Expiration and Custom Keys. See: Message Center Options.
  • Landing Pages are subject to size limits. See the Edit Template section for more detail.

See our Support article for more about Landing Pages and Message Center messages.

In this tutorial, you will:

  1. Preview and select a page template.
  2. Customize the rich page by modifying the text, images, and buttons.
  3. Save the rich page for use

Features and options are explained along the way.


From a message or test in the Message, Automation, or A/B Test composers, select either the Landing Page or Message Center action, then click the Create button.

Select Template

  1. Click the Preview button for any Custom or Standard template listed in the right-side menu under Select a template, then select channels at the top of the left-side pane to see how it will appear on different devices.Previously uploaded templates are listed under Custom Templates. Standard Templates options are Text, Image, Video, or Upload. If you have a template to add, see: Template Upload.

  2. Click the Select button next to the template you want to use.

Edit Template

If you want to go back to the list and choose a different template, click the left arrow in the header of the right-side menu, and confirm losing any changes.

  1. Click a content element in the preview to display the editable section in the right-side menu, or select directly from the menu. For Message Center, the menu is tabbed. See: Message Center Options.Each element is enabled by default. The ON/OFF toggle is located in the upper right-side corner of each selected element.
  2. Edit according to the options detailed in Content Elements.

Landing Page content is hosted in a CDN, ensuring responsive load times for your users globally. The hosted rich page content — including embedded CSS, images and JavaScript — is capped at 1536K. If you have additional assets to load, you may host them in another location and link from the Landing Page via URLs. Additional asset hosting options are available as a Professional Services engagement. Please [contact Airship Sales]( for more details.


Although we allow Landing Page sizes up to 1536K, the ideal size for a page is much smaller, given the potential for degraded download speeds on cellular networks. We recommend that you optimize your images and HTML to keep total page sizes under 100K.

Message Center Options


Enter a Title on the Message Center tab in the right-side menu. The Title is the message name shown in the Message Center list.

Remove From Message Center

On the Options tab in the right-side menu, the default setting is for a Message Center message to Never expire.

To set expiration, select the Specify radio button, then enter the number of Minutes, Hours, or Days when the page will expire after send time. The Message Center message will no longer appear in a user's Message Center after the expiration time is reached.

Custom Keys

Custom Keys, also known as key/value pairs, pass extra data through your Push Notification payload for use by custom code in your app.

Enter the key and value. Click the plus sign button for additional keys.


Common uses of custom keys include passing additional campaign identifiers for analytics, passing user profile information to the device, controlling the look and feel of the app, providing image links, etc.

Save Template

Click the Save & Exit button, or cancel to discard and/or choose a different Action. The button turns blue when a template can be saved.

If you are using either the Text or Image templates, you must satisfy the following before you can Save:

  1. Configure or disable the Action Link(s). Action Links are located in the Button element when using the Text template, and under both Button and Image elements when using the Image template.
  2. Enter a Message Center Title. Enter a Title on the Message Center tab in the right-side menu. Message Center only.

When the requirements are met, checkmarks appear for each above the Save & Exit button.

After saving your template, you have the option to Edit or Preview.

  • Edit returns you to the Rich Content Editor.
  • Preview opens an overlay of the previewer used in the Rich Content Editor.

Template Upload

If you have a template to add, from the Select a template screen, click Select next to Upload, then:

Landing Page only

  1. Click the Upload button.
  2. Select the HTML file.
  3. Select channels at the top of the left-side pane to see how it will appear on different devices.
  4. Click the Save & Exit button, or cancel to discard.

Message Center only

  1. Enter a title on the Message Center tab in the right-side menu.
  2. Click the Content tab, then click the Upload button.
  3. Select the HTML file.
  4. Select channels at the top of the left-side pane to see how it will appear on different devices.
  5. Click the Options tab in the right-side menu. See Message Center Options for detail.
  6. Click the Save & Exit button, or cancel to discard.

Content Elements

The elements listed here are used in the Standard Templates.

  • All templates contain Page, Headline, and Content.
  • The Video template also includes Video, which requires a URL.
  • The Text template also includes Button.
  • The Image template also includes Button and Image, and Headline is instead labeled Heading.
  • Headline and Content are text fields.


The Page element is where you can opt to add or remove a tag upon opening the rich page. This tags every user who opens the rich page, whether they've reached it through a push, a badge, or by chance. See Tags for setup steps.


Enter the Button's label in the text field, then choose which Action is linked to tapping the Button. You also have the option to add or remove a tag. See Action Links and Tags for setup steps.


While it is an option to disable the Action Link, doing so removes the Button from the rich page, leaving the Button label only. Since configuring or disabling Action Links is required to save a template, you may elect to disable it if you intend to edit the template at a later date.


Enter the path to the source image. Optionally include an Action linked to tapping the image.

If you choose to include an Action Link, you also have the option to add or remove a tag. See Action Links and Tags for setup steps.

An Action Link can be associated to tapping a Button or Image: Deep Link, URL, or Share. Click an action's icon, then follow the steps for each as described below. Click the X in the upper right corner to go back and choose a different Action Link.

Deep Link opens to a configured screen within your app or on the web. The Deep Link must be preconfigured, then selected from this dropdown menu. See: Manage Deep Links.

If you selected a Deep Link template, each template segment field will be available to fill in.

You can also provide a Deep Link from a Message Action. See: Message Actions: Action Types: Deep Link.

URL opens on top of the current page (in the same webkit view), not the mobile browser. Enter a URL.

You can also provide a URL from a Message Action. See: Message Actions: Action Types: Web Page.

Share prompts the user to share the message on social networks. Enter the text you would like to accompany the share, including any promotional information, shortened links, hashtags, etc.

You can prompt a user to Share in two additional places:

  1. A Message Action. See: Message Actions: Action Types: Share.
  2. An Interactive Notification button. See: Optional Content Features: Buttons.


Rich pages support two different tagging implementations:

  1. Set a tag when a user opens the rich page. See: Content Element: Page.
  2. Set a tag when a user taps a Button or Image. See: Content Element: Button and Content Element: Image.

Two options are displayed: Add tags and Remove tags. The functionality and buttons are identical for both. Click the appropriate button, then:

  1. Click the Select a tag button.

  2. Enter the tag in the search field.
    • Matches are listed below the + Create tag button. Click to select.
    • If the tag is not found, click the + Create tag button to add it.
    • Remove a selected tag by clicking the X at the end of its row.

Tags will not appear in the type-ahead tag search until the message goes out and the tag appears on at least one device. These tags are preserved in your draft but will not yet be visible to other aspects of the tag system, e.g., the Segments Builder.