# Configuring screens

Configure individual screens in the Native Experience editor, including background media, tags, actions, content elements, and AI-generated content.

Configure screens in the Content step when [creating a Scene](https://www.airship.com/docs/guides/messaging/in-app-experiences/scenes/create/) by selecting the file icon () in the left sidebar and then selecting one from the list. To add more, select ** Add screen** in the left sidebar. Scenes can have up to 20 screens.

For each, you can configure the following:

* [Set background color or media](#set-background-color-and-media) that appears behind the content elements.
* [Add content elements](#add-content-elements).
* [Set a tag](#set-a-tag) on the user when it displays.
* [Add an action](#add-an-action) that occurs when the user interacts with it.

![Configuring a new screen in a Scene](https://www.airship.com/docs/images/scene-screens_hu_9d2906369bcd705a.webp)

*Configuring a new screen in a Scene*

## Managing screens

Manage screens in the left sidebar:

| Option | Steps |
| --- | --- |
| **Rename** | Select and hold the three dots icon (
) for a screen, select **Rename**, enter a new name. |
| **Reorder** | Select and hold the three dots icon (
) for a screen, then drag and drop to a new position. |
| **Duplicate or delete** | Select the three dots icon (
) for a screen, then select **Duplicate** or **Delete**. You cannot delete the only screen in a Scene. |
 
## Set background color and media

![Screen background options](https://www.airship.com/docs/images/scene-background-color_hu_c20c273d7c1708bc.webp)

*Screen background options*

When configuring a screen, the right side sidebar displays options to set background color and media.

### Background color

The background color set here overrides the [default project setting](https://www.airship.com/docs/guides/messaging/in-app-experiences/configuration/defaults/#scene-defaults).

To set a background color:

1. Select the add icon () for **Background color**.
1. Select a [Color Set](https://www.airship.com/docs/reference/glossary/#color_set) or enter a hexadecimal color value, and then set the opacity percentage.

### Background media

Background media supports images and video. 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](https://www.airship.com/docs/guides/messaging/editors/native/elements/#media).

To set background media:

1. Select the add icon () for **Background media**, then enter a URL of an image or video to use as the background. URLs must be HTTPS and accessible by your mobile audience.
   <p>If your Airship plan includes CDN support, you can also upload media or select from previously uploaded media. See <a href="https://www.airship.com/docs/guides/messaging/features/media/#insert-media-in-message-content">Insert media in message content</a> in <em>Media library</em>.</p>
1. Select a Fit: Crop, Center crop, or Center inside. If you select Crop, also set a Position. For details about these settings, see [Media properties](https://www.airship.com/docs/guides/messaging/editors/native/design-properties/#media-properties) in *Design properties*.

### Video controls

[iOS SDK 20.6.2+](/docs/docs/developer/sdk-integration/apple/ios-changelog/#20.6.2) [Android SDK 20.5+](/docs/docs/developer/sdk-integration/android/changelog/#20.5.0)

If using background video, you can add play/pause and mute/unmute buttons to the screen, set their placement, and style their appearance. The Play control is not available in [Story](https://www.airship.com/docs/reference/glossary/#story) mode. Instead, use the [Play control setting for the root appearance](https://www.airship.com/docs/guides/messaging/editors/native/root/).

To add video controls:

1. Select the add icon () for **Video control**. Both **Play control** and **Audio control** are added by default. You can select the remove icon () to hide either.
1. Set the controls' alignment within the screen, as well as the background color and opacity. For each enabled control, set the size, as well as the icon color and opacity. For details about these settings, see [Media properties](https://www.airship.com/docs/guides/messaging/editors/native/design-properties/#media-properties) in *Design properties*.

## Set a tag

![Setting a tag on screen display](https://www.airship.com/docs/images/scene-set-tag_hu_9c7ada687c5953cd.webp)

*Setting a tag on screen display*

To set a tag when the screen displays, enable **Set a tag**, enter the tag you want to set, then select from the list of returned tags or select **Create new tag**.

## Add an action

[iOS SDK 18.12+](/docs/docs/developer/sdk-integration/apple/ios-changelog/#18.12.0) [Android SDK 18.4+](/docs/docs/developer/sdk-integration/android/changelog/#18.4.0)

![Configuring an action for a screen](https://www.airship.com/docs/images/scene-add-action_hu_f9cbee0a830afc65.webp)

*Configuring an action for a screen*

You can set a behavior that occurs when a user taps/clicks the screen. You can also:

* Set a Scene behavior
* Set or remove a tag
* Opt a user in to or out of a [Subscription List](https://www.airship.com/docs/reference/glossary/#subscription_list)
* Emit a [Custom Event](https://www.airship.com/docs/reference/glossary/#custom_event)

Tap/click events are reported using the [In-app button tap event](https://www.airship.com/docs/developer/rest-api/connect/schemas/events/#in-app-button-tap) in the format <code>button-tap-&lt;event name&gt;</code>. For example, if you enter <code>Cat socks55</code> for any action, the event name in reporting will be <code>button-tap-Cat socks55</code>. Event names also support [Handlebars](https://www.airship.com/docs/reference/glossary/#handlebars).

Enable **Add an action**, then follow the steps in [Actions for in-app experiences](https://www.airship.com/docs/guides/messaging/in-app-experiences/configuration/button-actions/). Also refer to the table of [supported actions for screens](https://www.airship.com/docs/guides/messaging/in-app-experiences/configuration/button-actions/#actions). An event name for the action is required.

## Add content elements

To add content elements, select the add icon (
) and make a selection. See [Configure content elements](https://www.airship.com/docs/guides/messaging/editors/native/elements/) for detailed steps.

![Add and manage content elements](https://www.airship.com/docs/images/scene-content-add_hu_6db4648151e288ba.webp)

*Add and manage content elements*

After adding content elements, you can manage them in the center panel and left sidebar:

| Option | Steps |
| --- | --- |
| **Edit, duplicate, or remove** | Hover over an element and select the edit (), copy (), or delete icon (). To go directly to editing an element, double-click its name in the left sidebar. |
| **Fix container at bottom on scroll** | Hover over a Container element and select the pin icon () to keep the Container visible at the bottom of the screen when the user scrolls. When pinning multiple Containers, they appear in the order set when unpinned. To change their order, first unpin them, drag to a new order, then pin again. You cannot pin Containers nested inside other Containers. |
| **Reorder or move** | To reorder content elements within a screen, select and hold the drag handle icon () for an element, then drag and drop to a new position.<p>To reorder and move elements within a screen or container in the left sidebar, toggle the caret icon () to expand and collapse the lists of each screen's content elements and elements inside containers. Select and hold an element name and drag and drop to a new position. |

### Container navigation

To navigate between Containers and back to the root screen, you can select them in the left sidebar or use the breadcrumbs above a screen's content elements in the center panel. For example, when editing a container nested in another container, the breadcrumbs appear as `Screen > Container > Container`:

![Navigating Containers using breadcrumbs](https://www.airship.com/docs/images/scene-container-navigation_hu_16faacb44224e2e7.webp)

*Navigating Containers using breadcrumbs*

## Providing disclosures and other required information

It is important to state or link to necessary disclosures and other legal information within your communications to ensure regional regulation compliance and transparency with your users. For [SMS](https://www.airship.com/docs/guides/messaging/editors/native/elements/#sms), this includes disclosure of added SMS fees. For [Email](https://www.airship.com/docs/guides/messaging/editors/native/elements/#email), this may include disclosure requirements for email collection for marketing purposes.

While the exact placement is flexible, make sure the disclosure text and links are easily discoverable on the screen. Common and effective locations include next to an input field or prominently in the screen footer.

Use the [Text element](https://www.airship.com/docs/guides/messaging/editors/native/elements/#text) to add information that should appear on the current screen.

* To add a link for a selected portion of the text, use [Markdown styling](https://www.airship.com/docs/guides/messaging/editors/native/about/#markdown-styling).
* To make the entire text block function as a link, select **Add action** when configuring the Text element, choose **Web Page** or **Deep Link**, and enter the URL for the additional information. See the following in *Actions*:
   * [Web Page](https://www.airship.com/docs/guides/messaging/in-app-experiences/configuration/button-actions/#web-page)
   * [Deep Link](https://www.airship.com/docs/guides/messaging/in-app-experiences/configuration/button-actions/#deep-link)

> **Important:** When collecting phone numbers or email addresses using Scenes functionality, customers are responsible for ensuring compliance with all applicable regulations. This includes providing appropriate disclosures and obtaining necessary consent as required by law. Customers should include links to their SMS program terms and/or privacy policy as applicable to their specific use case and jurisdiction.

