Create a scene

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

Audience

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.

Content

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.

   • Text — Select Header, Body, or Footer and enter text. For Footer, also select and configure its ActionA configurable behavior that occurs when a user interacts with your message, e.g., opening a web page. : Home, Deep Link, Adaptive Link, or Web Page. 15 text elements maximum per screen.

   • Buttons — Enter the button label text and select an action. If there are two buttons total, choose a button layout: separate, joined, or stacked. Options:

     • Add or remove a TagMetadata that you can associate with channels or named users for audience segmentation. Generally, they are descriptive terms indicating user preferences or other categorizations, e.g., wine_enthusiast or weather_alerts_los_angeles. Tags are case-sensitive. or opt a user in to or out of a Subscription ListAn audience list of users who are opted in to messaging about a specific topic. Users can manage their opt-in status per list using a preference center. when they tap the button. See: Button options.
     • Check Fix at bottom on scroll to keep buttons visible at the bottom of the screen when the user scrolls.

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

     1. Select Upload and click Insert Media.

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

     3. (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.

     4. Click Insert selected media.

     

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

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

        1. Select Upload and click Insert Media.

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

        3. (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.

        4. Click Insert selected media.

        

     2. Enter text for the list item.

     3. Click Add another and repeat steps for each list item.

   ---

   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.

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

     3. (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.

     4. Click Insert selected media.

     

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

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

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.

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