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

# What is Composition? How to create a Composition?

> Learn about compositions and how to create them in Pickcel to arrange and present content on your digital signage screens

## What is Composition?

A **composition** is the final screen output you publish. It combines a layout, the media you add, and one or more <Tooltip tip="A designated segment of the screen that runs its own playlist.">zones</Tooltip>, so you can decide exactly what plays and where on the display for your digital signage screens.

<Info>
  Learn [what a layout is and how to create a custom layout](/compositions/layouts) in Pickcel.
</Info>

## How to create a Composition in Pickcel console

<Steps>
  <Step title="Open Composition and click Add Composition">
    Log in to your [Pickcel Console](https://console.pickcel.com/). In the left menu, expand **Content** and select **Composition**, then click **Add Composition** in the top-right corner.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/add-composition/compositions-01-add-composition.uPwP3UlmoIXL.png" alt="Compositions page in the Pickcel console with the Add Composition button in the top-right" />
    </Frame>
  </Step>

  <Step title="Choose a layout">
    On **Choose Layout**, pick the structure that matches your screen. Use the **All**, **Portrait**, **Landscape**, and **Custom** tabs, or **Search layout by name**, to find one, then click **Use this layout**.

    <Tip>
      Need a structure that isn't listed? Click **+ Create Custom Layout** and follow the [Layouts](/compositions/layouts) guide to build your own.
    </Tip>

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/add-composition/compositions-02-choose-layout.kINuSYQwzKcM.png" alt="Choose Layout step with All, Portrait, Landscape, and Custom tabs, a search box, and Use this layout buttons" />
    </Frame>
  </Step>

  <Step title="Get to know the composition editor">
    The editor opens on the **Select Media** step. Your **media library** sits on the left, and the **zones** for your chosen layout are on the right, each with its own **Zone** tab (Zone 1, Zone 2, and so on). The **Total Duration** for the selected zone is shown above the tabs.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/add-composition/compositions-03-editor-zones.i0aYUpq4e8JA.png" alt="Composition editor with the media library on the left and Zone 1 and Zone 2 tabs on the right" />
    </Frame>

    <Note>
      Filter the media library with the **All**, **Images**, **Videos**, **Apps**, and **PDFs** tabs, or click **Upload New File** to add something new without leaving the editor.
    </Note>
  </Step>

  <Step title="Add media to a zone and set its duration">
    Make sure the zone you want is selected, then click the **+** button on any media row to add it to that zone's playlist. Each item shows inline **−**, duration, and **+** controls, so you can set how many seconds it plays. The zone's **Total Duration** updates as you go.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/add-composition/compositions-04-add-media-duration.09AHAl5YLWT6.png" alt="A media item added to Zone 1 with minus, duration, and plus controls and the Total Duration updated" />
    </Frame>

    <Tip>
      Drag the handle on a playlist item to reorder it, or hover over an item to remove it from the zone.
    </Tip>

    <Note>
      You can set the duration for images, but not for videos. A video always plays for its full length, so its playback isn't cut off mid-stream.
    </Note>
  </Step>

  <Step title="Fill the remaining zones">
    Select the next **Zone** tab and repeat the previous step until every zone has the media you want.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/add-composition/compositions-05-zone2-filled.G0NLOJpAFNSJ.png" alt="Zone 2 selected with an app added to its playlist" />
    </Frame>
  </Step>

  <Step title="Preview your composition">
    Once your zones are filled, click **Preview** to see exactly how the composition will look on screen before you save it.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/add-composition/compositions-06-preview.2niO1hx7IDKc.png" alt="Preview window showing the composition playing across its zones" />
    </Frame>
  </Step>

  <Step title="Name and save your composition">
    Rename the composition using the field (and **pencil** icon) at the top-left. When you're ready, click **Save composition**. In the **Save composition** dialog, confirm the name and click **Save & exit**.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/add-composition/compositions-08-save-dialog.Kzo9yoZ0VpOk.png" alt="Save composition dialog showing the composition name with Cancel, Save and continue, and Save and exit buttons" />
    </Frame>

    <Note>
      Choose **Save & continue** instead if you want to keep editing after saving.
    </Note>
  </Step>

  <Step title="Find your composition in the list">
    Your saved composition appears in the **Compositions** list, with its **Date**, **Duration**, **Created By**, and any linked **Schedules**.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/add-composition/compositions-09-saved-list.oCKP8pBqN5yv.png" alt="Compositions list showing the newly saved composition with its date, duration, and creator" />
    </Frame>
  </Step>
</Steps>

<Note>
  **What's Next?**

  * Build a [**custom layout**](/compositions/layouts) for zone arrangements the standard templates don't cover.
  * [**Schedule and publish**](/schedule-and-publish/publish-overview) your composition to your screens.
  * Set a [**default composition**](/settings/default-composition) so screens always have something to play.
</Note>
