---
title: "Add a screen"
slug: "add-a-screen"
updated: 2026-06-01T07:57:16Z
published: 2026-06-01T07:57:16Z
canonical: "docs.grassfish.com/add-a-screen"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.grassfish.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add a screen

To add a new screen, perform the following steps:

1. In the sidebar, click **Screens**.
2. Click **New Screen** in the header. ![](https://cdn.document360.io/e2b87f73-d9f5-43cb-8182-2641762664fd/Images/Documentation/screens_new.png?sv=2026-02-06&spr=https&st=2026-10-26T12%3A29%3A27Z&se=2026-10-26T13%3A29%3A27Z&sr=c&sp=r&sig=T31NETQfEn7bpxVRJaI6Y7htz0VbhDpGzQdQ4nEE31E%3D)
3. Enter the required details:

![Create a new screen](https://cdn.document360.io/e2b87f73-d9f5-43cb-8182-2641762664fd/Images/Documentation/image-1775806133897.png?sv=2026-02-06&spr=https&st=2026-10-26T12%3A29%3A27Z&se=2026-10-26T13%3A29%3A27Z&sr=c&sp=r&sig=T31NETQfEn7bpxVRJaI6Y7htz0VbhDpGzQdQ4nEE31E%3D)
  - **Screen name**: Enter a name for the screen. Apply a naming structure that allows easy identification.
  - **Screen ID:** Optionally, enter a unique identifier for the screen. For example, if needed for an integration with your business systems.
  - **Location**: Select a [location](https://docs.grassfish.com/ixm-aqua/docs/work-with-locations)**.**
  - **Tags**: Optionally, add [tags](https://docs.grassfish.com/ixm-aqua/docs/tags) to categorize your screens.
  - **Screen orientation**: select **Landscape** or **Portrait** mode.
  - **Channel**: Select a [channel](/ixm-aqua/docs/work-with-channels).
  - Use one of the following **Screen type** options:
    - **Use channel setting**: Select to apply the channel’s screen format to the screen.
    - **Screen type**: Select a screen type that matches the screen orientation. If you use [Share of Voice](https://docs.grassfish.com/ixm-aqua/docs/share-of-voice) and want to enable it on a screen, select **Portrait SOV** or **Landscape SOV**.
  - **Pair screen now**: Select and enter the six-digit code that appears on the physical screen to pair it with your account. If the screen isn't ready for pairing, deselect and enter the code later in the [screen settings](https://docs.grassfish.com/ixm-aqua/docs/work-with-screens).
4. Click **Save** to save your changes.

The application's main menu on the left side.

The top section of the interface.