Create a Scene

Set up multi-screen in-app experiences, with no development required. AXP

These steps walk you through creating a new Scene using the Scene composer. You can also create a draft Scene from the Journey MapA visualization of messaging components that can be connected to create a continuous user experience. You can also create and edit from the map. then edit and complete the steps described here. See Creating draft components in Create a Journey.

Getting started

Select the add icon () in the dashboard header, then select Scene. Each step is labeled in the center of the header:

After completing a step, select the right arrow icon () to move on.


If you want to flag the Scene as a test, select the gear icon () and enable Mark this message as a test. You can do so in any step.


  1. Enter a name that represents 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..

  2. (Optional) Configure optional features:

    • Start and end dates
    • Repeat
    • Message priority
    • Ignore channel message limits
    • Campaign categories
    • Override default missed behavior action
    • Custom keys
  3. (If present) Set or verify the Message PurposeA dashboard setting that designates a message as commercial or transactional.. The Purpose setting only appears if enabled for the project.


Determine who can see your Scene:

All UsersYour entire app audiencen/a
Target Specific UsersAudience members in a SegmentA grouping of audience members selected by unique or shared identifiers. Multiple identifiers can be combined within a segment. you createFollow the steps in Target Specific Users to create a single-use Segment.
Test UsersMembers of a Test GroupA preview group is audience group used for previewing personalized content in the dashboard. Wherever a personalization preview is available, you can select a preview group, and its group members’ attributes will appear for any Handlebars references to attributes. You can enable any preview group as a test group so you can send test messages to its group members. These messages appear as tests in Messages Overview.Select a Test Group.
Feature Flag AudienceMembers of a Feature FlagA toggle for controlling the availability of content or functionality in your app. Flag properties enable making immediate app code updates. audienceSearch for a flag by name, display name, description, or status. Active, Scheduled, or Ended flags only.

If your Airship plan includes Feature FlagsA toggle for controlling the availability of content or functionality in your app. Flag properties enable making immediate app code updates., you can set up a Scene RolloutA method of limiting a Scene’s total or targeted audience by percentage.. After selecting All users or Target specific users, enable Audience Allocation, and then set a percentage. You can change the percentage at any time. For Target Specific Users, the percentage applies to users who meet the set conditions.


  1. Select Start from Scratch or a content layout. Toggle Default and Custom to see available content layouts. For Custom, you can search by layout name or description. After selecting a layout, it appears in the device preview. Select the arrows to page through each screen.

    See Content layouts in About Scenes and the Creating custom content layouts configuration guide.

  2. Select Continue with selection. You can change your selection up until selecting Done when editing screens.

  3. Configure settings for the entire Scene and the content of each screen. Follow the steps in Configure Scene content.


Configure the event that will cause the Scene to appear to users. You can also configure cancellation events and conditions for displaying the Scene.

Follow the steps in In-app experience triggers.


Review your Scene appearance and summary.

Select Finish to make the Scene active. If you exit before selecting Finish, the Scene is saved as a draft.