Create a Scene

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.

Settings

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.

Audience

1. Determine who can see your Scene:

   Option	Description	Configuration
   All Users	Your entire app audience	n/a
   Target Specific Users	Audience members in a SegmentA grouping of audience members selected by unique or shared identifiers. Multiple identifiers can be combined within a segment. you create	Follow the steps in Target Specific Users to create a single-use Segment.
   Test Users	Members 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 Audience	Members of a Feature FlagA toggle for controlling the availability of content or functionality in your app or website. audience	Search for a flag by name, display name, description, or status. Active, Scheduled, or Ended flags only.

2. (For All users and Target specific users only) To limit the total audience, enable Audience Allocation and then set a percentage.

   When used with Target Specific Users, the percentage applies to users who meet the set conditions. You can change the percentage at any time. See Controlled rollouts in About Scenes.

Content

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.

Behavior

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

Review your Scene appearance and summary.

• For Scenes with more than one screen, select the arrows at the side of the screen to page through each screen’s preview and content 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.
• If you selected Feature Flag Audience in the Audience step, compare the flag and Scene start and end dates in the Schedule section to make sure your intended timing is set up correctly.
• If you want to make changes, select Edit, make your changes, then either select the right arrow icon () or select the central navigation dot to return to the Review step.

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