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

# Manage screens in your Piksel dashboard

> View screen status, configure rotation and location, assign playlists, and remove screens from your Piksel dashboard.

The **Screens** section of your Piksel dashboard gives you a central view of every display linked to your account. From here you can check whether a screen is online, adjust how it is oriented on the wall, set its physical location, assign content to play, and remove screens you no longer use.

## Screen list and status

The screens list shows every display you have paired. Each screen card shows its name, location, currently assigned playlist, and live connection status — either **Online** or **Offline**.

<Note>
  Status is determined by heartbeat freshness. When a screen has not sent a heartbeat to Piksel for approximately two minutes, its status changes to **Offline**. As soon as the screen reconnects and sends a heartbeat, its status returns to **Online** automatically.
</Note>

## Pairing a new screen

Before a screen appears in your list, it must be paired to your account. See [Pairing screens](/pairing-screens) for the full step-by-step walkthrough using the 6-digit code shown on your Apple TV.

## Configuring screen settings

Select any screen from the list to open its detail view. From there you can update the following settings.

<AccordionGroup>
  <Accordion title="Name">
    Give the screen a descriptive name so you can identify it in the dashboard, schedules, and smart rules — for example, `Lobby Display` or `Menu Board — Counter 2`.
  </Accordion>

  <Accordion title="Rotation">
    Set the physical orientation of the display. Choose the option that matches how the screen is mounted.

    | Value  | Orientation                              |
    | ------ | ---------------------------------------- |
    | `0°`   | Landscape (default)                      |
    | `90°`  | Portrait — rotated 90° clockwise         |
    | `180°` | Landscape — flipped upside down          |
    | `270°` | Portrait — rotated 90° counter-clockwise |
  </Accordion>

  <Accordion title="Location name">
    Enter a human-readable label for where the screen is located, such as `Main Entrance` or `Drive-Through`. This label appears in the dashboard and in email notifications.
  </Accordion>

  <Accordion title="Weather coordinates">
    Provide the latitude and longitude for the screen's physical location. Piksel uses these coordinates to fetch live weather data when evaluating [smart rules](/features/smart-rules).

    <Warning>
      Smart rules that use weather or temperature conditions will not trigger if no location coordinates are set on the screen.
    </Warning>
  </Accordion>
</AccordionGroup>

## Assigning a playlist to a screen

You can assign a default playlist directly to a screen. This is the content that plays when no schedule or smart rule is overriding it.

<Steps>
  <Step title="Open the screen detail">
    From the screens list, select the screen you want to configure.
  </Step>

  <Step title="Select a playlist">
    In the **Playlist** section of the screen detail, choose a playlist from the dropdown. The list shows all playlists in your account.
  </Step>

  <Step title="Save your changes">
    Click **Save**. The screen receives the updated playlist in real time.
  </Step>
</Steps>

<Tip>
  To play different content at different times of day, use [schedules](/features/schedules) rather than reassigning the playlist manually.
</Tip>

## Deleting a screen

Deleting a screen removes it from your account and deletes all schedules associated with it. The playlists and media assigned to the screen are not affected.

<Steps>
  <Step title="Open the screen detail">
    Select the screen from the screens list.
  </Step>

  <Step title="Delete the screen">
    Click **Delete screen** and confirm the action when prompted.
  </Step>
</Steps>

<Warning>
  Deleting a screen also deletes all schedules configured for that screen. This action cannot be undone.
</Warning>
