Create a scene

Set up multi-screen experiences to guide your users through your app, with no development required.

To get started, click   and select Scene. After completing a step, click   in the header to move on. Click   if you want to change the scene name or flag it as a test.


Enter a scene name. The name should represent the purpose of the scene, e.g., “Account Upgrade.” The name appears in reporting and Messages OverviewA view of all your project’s messages, journeys, and A/B tests, with options for editing their settings, content, status, and more. .

After entering a name, you may configure optional features.


Select your scene audience:

  • All Users: Display the scene to your entire audience.
  • Test Users: Predefined recipient groups. After choosing Test Users, select from the Test Groups dropdown menu that appears. See: Preview and Test Groups.
  • Target Specific Users: Create a recipient group based on available conditions. See: Target Specific Users: In-App Automation.


Configure the content of your scene. See About scenes: Appearance and behavior for configuration details.

First select Start from Scratch or a template and click Continue with selection. You cannot change your selection after continuing.

Click Settings in the sidebar to choose the scene style and configure the dismiss button. Enter a hexadecimal value for the button color.

To customize the screens in your scene:

  • If creating from scratch, click Add content.
  • If using a template, at the top of a screen, click   then   Edit.
  • For more screens, click Add screen then Add content.

The following steps apply to all screens in a scene.

Click Design in the sidebar to set the appearance of the scene background, headers, body, and buttons. These settings are for this scene only and override your project-level design settings. Enter hexadecimal values for colors.

Select a layout, then configure each element. For screens in a template, layouts are preselected.

A preview updates as you type and make selections. Available fields and options vary per layout.

  • Background and Media — Enter an HTTPS URL that will be accessible by your mobile audience. If your Airship plan includes CDN support you can also upload media or select from previously uploaded media. Contact Support if you are interested in enabling CDN media hosting.
    1. Select Upload and click Insert Media.

      1. Click Choose file and select a file to upload, or select from previous uploads.

        • The default sort order is most recent upload first.
        • You can search by file name or keyword.
        • A file preview appears after upload or selection. Click   to preview audio and video files.
      2. (Optional) Add or edit keywords for the file to help organize your uploads.

        • Enter a term in the search field below the preview and select from results, or click Add keyword: [term].
        • Click   to remove a keyword.
      3. Click Insert selected media.

    2. Text — Enter header and body content.

    3. Footer — Some scene layouts include a Footer field, which is designed to link to your Terms and Conditions, Privacy Policy, or additional information to help the user make a more informed decision about the actions they could take in this message.

      The footer inherits the styling of the body text and functions as a button. Enter text for the footer, then select and configure its action.

    4. Buttons — Click Add button, then enter a button label and select an action. If there are two buttons total, choose a button layout: separate, joined, or stacked. You can add or remove a TagMetadata that you can associate with channels or named users for audience segmentation. Generally, they are generally descriptive terms indicating user preferences or other categorizations, e.g., wine_enthusiast or weather_alerts_los_angeles. Tags are case-sensitive. when the button is pressed. See: Set a tag.

    5. ListBullet list layout only

      1. Enter a header and optional body.
      2. Click Add list.
      3. Provide media for the bullet. See information provided for Background and Media above.
      4. Enter text for the list item.
      5. Click Add another and repeat steps for each list item.
    6. Tag — Set a tag when the scene is displayed. Enable, then enter the tag you want to set. Click to select from the list of existing tags, or click Create new tag: [entered tag].

    Click Done to return to the view of all the screens in the scene.

    • To duplicate or remove a screen, click   at the top of a screen, then click   Duplicate or   Delete.

    • To reorder screens, click and hold   at the top of a screen, then drag and drop to a new position.


    Configure the trigger that will cause the scene to appear to users. You must configure at least one trigger, and you can also set cancellation events and additional display conditions.


    Review your scene. If you want to make changes, click EDIT, make your changes, then either click   or click the central navigation dot to return to the Review step. If you exit before this final step, the scene is still a draft and not yet active.

    Click Finish to make the scene active.