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.

Settings

Enter the 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, configure optional features and set or verify the Message PurposeA designation of a message as commercial or transactional. . Purpose only appears if enabled for the project.

Audience

Select your scene audience:

Content

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 and can configure each Content section: Settings, Screens, and Design.

After completing configuration, click Done to save changes to all edited screens. You will then see a collapsed view of the screens. Click the arrows to page through each screen. Click Expand   to see the screens side by side. Preview options are the same as when editing screens. See: Preview tools.

Settings

Settings configuration applies to all screens.

  • Style — Required. Select Modal or Fullscreen.

  • Respect safe area — Optional, enabled by default. The “safe area” defines the portion within a view in your app’s interface that is not covered by physical or UI elements, such as a status bar or notch. This setting is enabled by default. Uncheck to ignore safe area insets and extend the content to the full height and width of the device.

  • Dismiss button — Optional. Click  , then select a Color SetA named pair of hexadecimal color values supporting device Light and Dark modes. Color sets can be selected for any color field in a scene and when configuring the default appearance of surveys, scenes, and in-app automations. Dark mode is supported for scenes only. or enter a hexadecimal color value for the button color.

  • Show indicators — Optional, for scenes with multiple screens only, enabled by default. Uncheck to hide the dots that indicate the number of screens. This setting cannot be disabled when Story mode is enabled, ensuring the appearance of the progress bar that indicates the number of screens and their remaining duration.

  • Enable swipe — Optional, for scenes with multiple screens only, enabled by default. Uncheck to require interaction with buttons and prevent swiping between screens. This setting cannot be enabled when Story mode is enabled.

  • Story mode — Optional. Minimum SDKs required: iOS and Android 17.0. Click  , then enter the number of seconds (1-60) to display each screen and determine what happens after the story ends:

    • Loop — The scene replays indefinitely.
    • Display last screen — The last screen of the scene continues to display.
    • Dismiss — The scene closes.

    Story mode does not support:

    • Scrolling — Make sure to design screens for small device dimensions to eliminate the appearance of a non-functional scroll bar.
    • Video
    • Questions or NPS

    The Story mode option is disabled if the scene contains video, questions, or NPS.

Screens

When configuring Screens, the left sidebar indicates the current screen.

  • Adding screen elements — Click   to add elements. After adding an element, you can click   to edit, duplicate, or delete. Click and hold   to drag and drop an element to a new position.

  • Setting tags — To 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].

  • Adding and managing screens — Click   Add screen to add another. You can access options next to the screen names:

    • Reorder — Click and hold  , then drag and drop to 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.

Preview tools

The device preview updates as you type and make selections. Use the tools in the page header to adjust the preview.

If you are using personalized content, the preview displays the default values. You can also enable Preview Data and enter your own JSON sample data or select a Preview GroupA preview group is an audience group you create for previewing personalized content in the dashboard. Wherever a personalization preview is available, you can select a preview group, and those users’ attributes will appear for any Handlebars references to attributes. You can enable any preview group as a test group so the users can receive test messages sent to the group. These messages appear as tests in Messages Overview. user. See: Previewing personalized content.

Design

When configuring each screen, the right side sidebar displays overrides for your project-level design defaults for the selected screen only. You also have the option to set media as the background. For additional detail about settings, see: In-App Experience Defaults.

For background color, select a Color SetA named pair of hexadecimal color values supporting device Light and Dark modes. Color sets can be selected for any color field in a scene and when configuring the default appearance of surveys, scenes, and in-app automations. Dark mode is supported for scenes only. or enter a hexadecimal color value. 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.

Background video displays in portrait mode, starts automatically, and plays in a loop. (Orientation and behavior are different for video used in the Media element.) Video requires iOS and Android SDKs 17+.


To override the design settings for an individual element, click   and select   Edit. The sidebar will update with options for that element.

For all elements except Media and Button Group, first select from the default Header, Body, and Footer text styles defined for Modal and Fullscreen messages. Footer is available for the Text element only. You can then override specific properties:

For the NPS and Question elements, text configuration for questions, answers, and labels are in separate sections in the sidebar.

For the Button Group element, first select from your default button styles defined for Modal and Fullscreen messages. You can then override specific properties:

The Media element does not have design settings.

Content: Screen elements

Refer to this information when configuring each screen. See also: About scenes: Appearance and behavior.

Button group

Enter the button label text and select an action. If there are two buttons total, choose a button layout: separate, joined, or stacked. If your scene includes a question or NPS, you must configure a button using the Submit Responses action. Options:

List

Provide media that serves as the bullet and enter text for the list item.

  1. 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.
  2. Enter text for the list item.
  3. Click Add another and repeat steps for each list item.

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. 10 media elements maximum per screen. Video is not supported in story mode.

Video displays in landscape mode and does not start until a user clicks the Play button. (Orientation and behavior are different for background video.) Video requires iOS and Android SDKs 17+.

You can enter alternative text that can be announced by assistive technology, such as screen readers. Alternative text, also known as alt text, is a textual description of an image or video that is used when a person can not see or access the visual image to help them understand its meaning.

NPS

Scenes support a single NPS survey. NPS is not supported in story mode. NPS requires iOS and Android SDKs 16.9+.

  1. Enter question text.
  2. Enter range label text. E.g., Not at all likely and Extremely likely.
  3. (Optional) Check the Required checkbox to make answering the question a requirement for submitting responses.

Question

Scenes support up to 10 questions. Questions are not supported in story mode. Questions require iOS and Android SDKs 16.9+.

  1. Select a question type: Single Choice, Multiple Choice, or Open Text.

  2. Enter question and answer text. To reorder your content click and hold   and drag and drop in new positions in the screen or question element.

  3. (Optional) Check the Required checkbox to make answering the question a requirement for submitting responses.

  4. (Optional for Single Choice and Multiple Choice questions) Check the Randomize order checkbox to present the answers in random order when the survey is viewed in the app. The answer order is ignored if you check Randomize order.

  5. (Optional for Single Choice questions) Enable Store as Attribute to store responses as text or number AttributesMetadata that you can use for audience segmentation. Attributes differ from tags in that when evaluating users with attributes, Airship uses operators, e.g., equals, less than/greater than, contains, before/after, to determine whether or not to target a user. Supported attribute types are TEXT, NUMBER, and DATE. , then:

    1. Search for and select an attribute.
    2. Enter a value next to each answer. The value entered must match the attribute type (text or number). If empty, the response is not stored as an attribute. You must add attributes to your project before you can use them in surveys. You cannot use the same attribute in multiple questions in a single survey.

Text

Enter text. To make the text function as a link, click Add action, then select and configure one of:

15 text elements maximum per screen.

 Tip

You can add a link to your privacy terms in a footer with the Web Page action. Privacy terms can help users understand your data collection practices.

Media library

If your Airship plan includes CDN support, you can also upload media or select from previously uploaded media when configuring background media in the Design settings or List and Media content.

  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.

    See also: Media library. Contact Support if you are interested in enabling CDN media hosting.

    Behavior

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

    Review

    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. Toggle the Light/Dark selector above the preview to see the appearance of elements with an assigned Color SetA named pair of hexadecimal color values supporting device Light and Dark modes. Color sets can be selected for any color field in a scene and when configuring the default appearance of surveys, scenes, and in-app automations. Dark mode is supported for scenes only. . Light Mode values appear in Dark Mode preview if no Dark Mode value was entered for a color set.

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