Create a scene

Set up multi-screen experiences to guide your users through your app, with no development required. Scenes are an AXP feature.

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

  1. Select Start from Scratch or a template, then click Continue with selection. You cannot change your selection after continuing.

    You will then see the first screen in the scene.

    Click   Add screen to add another.

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

  3. Configure the content and order of your screens. The left sidebar indicates the current screen, and you can switch back and forth between screens by selecting from the sidebar. Options:

    • Reorder — Click and hold  , then drag and drop in a new position.
    • Duplicate or Delete — Click  , then click   Duplicate or   Delete. If your scene has a single screen, you can duplicate but not delete.

    Click   to add elements. A preview updates as you type and make selections. After adding an element, you can click   to edit, duplicate, or delete it. You can also click and hold  , then drag and drop in a new position.

    You can set a tag when the screen is displayed. Enable Set a tag, then enter the tag you want to set. Click to select from the list of existing tags, or click Create new tag: [entered tag].

    Edit the Design settings in the right sidebar to override your project-level design settings for the selected screen only. You can edit the appearance of its background, headers, body, and buttons.

    • Enter hexadecimal values for colors.
    • To use media as the background for a screen, 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.
      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.

        Contact Support if you are interested in enabling CDN media hosting.

    • Click Done to save changes to all edited screens. You will then see a collapsed view of the screens in the scene. Click the arrows to page through multiple screens. Click Expand   to see screens side by side.


    Configure the trigger that will cause the scene to appear to users. You can also configure cancellation events and display conditions.


    Review your scene before making it active. For scenes with more than one screen, click the arrows to page through each screen’s preview and summary.

    Click Finish to make the scene active. If you exit before clicking Finish, the scene is still a draft and not yet active.