> ## 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.

# How to delete a composition in Pickcel?

> Learn how to delete a composition in Pickcel, and what to do when a composition cannot be deleted

Remove a composition you no longer need from the **Composition** module. If something on your account still uses it, Pickcel blocks the delete and tells you exactly what to clear first.

<Warning>
  Deleting a composition is permanent, there's no undo and no trash to restore it from. If you only need to change what it plays, [edit the composition](/compositions/edit-composition) instead, your changes reach every screen using it automatically.
</Warning>

## Delete a composition

<Steps>
  <Step title="Open the Composition list">
    Log in to [Pickcel console](https://console.pickcel.com) and go to **Content → Composition**.
  </Step>

  <Step title="Click the three dots and select Delete">
    Find the composition, click the **⋯** menu at the end of its row, then choose **Delete**.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/delete-composition/dc-01-three-dot-menu-delete.sN_-txWkeoPK.png" alt="Composition list with the three-dot menu open showing View Details, Assign as quickplay, Edit, Duplicate, and Delete" />
    </Frame>
  </Step>

  <Step title="Confirm the deletion">
    In the **Delete "composition name"?** dialog, click **Delete**.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/delete-composition/dc-02-delete-confirm-dialog.hpb6Ch67f4ky.png" alt="Delete composition confirmation dialog" />
    </Frame>

    If nothing is using the composition, it disappears from the list right away. If something is, you'll see a **Cannot delete composition** message instead, see below.
  </Step>
</Steps>

## Why can't I delete my composition?

A composition can't be deleted while it is still referenced somewhere. Pickcel checks three things, and the error message names the exact items blocking you:

| What's blocking it                                    | Message you'll see                                                                 | Where to clear it                |
| :---------------------------------------------------- | :--------------------------------------------------------------------------------- | :------------------------------- |
| A **schedule** includes the composition               | *This composition is referenced by a schedule and cannot be deleted.*              | **Publish → Schedules**          |
| A **Quickplay** is using the composition              | *This composition has active quickplay references and cannot be deleted.*          | **Publish → Quickplay**          |
| The composition is a screen's **default composition** | *This composition is set as default on one or more screens and cannot be deleted.* | **Screen → \<screen> → Content** |

Pickcel also names the exact schedules, Quickplays, or screens still using the composition, so you know where to go next.

<Frame caption="A schedule is using the composition">
  <img src="https://cdn.pickcel.com/images/pickcel-docs/delete-composition/dc-04-cannot-delete-schedule.dthL2DWivXFD.png" alt="Cannot delete composition dialog stating the composition is referenced by a schedule, listing the schedule name" />
</Frame>

<br />

<Frame caption="A Quickplay is using the composition">
  <img src="https://cdn.pickcel.com/images/pickcel-docs/delete-composition/dc-05-cannot-delete-quickplay.9LOEesubZd7d.png" alt="Cannot delete composition dialog stating the composition has active quickplay references, listing the Quickplay name" />
</Frame>

<br />

<Frame caption="The composition is a screen's default">
  <img src="https://cdn.pickcel.com/images/pickcel-docs/delete-composition/dc-06-cannot-delete-default.uhXDiIfKVtDJ.png" alt="Cannot delete composition dialog stating the composition is set as default on one or more screens, listing the screen name" />
</Frame>

<Note>
  Pickcel reports one blocker at a time. Clear the schedules first, retry the delete, and if a Quickplay or a default composition is also using it, the next message tells you.
</Note>

## Find out what's using a composition

The **Composition** list has a **Schedules** column. Any composition that's part of a schedule shows a linked count.

<Frame>
  <img src="https://cdn.pickcel.com/images/pickcel-docs/delete-composition/dc-03-schedules-column-count.497GuiHswSQG.png" alt="Compositions list showing a linked schedule count in the Schedules column for one composition" />
</Frame>

Click the number to jump straight to **Publish → Schedules**, filtered to just the schedules using that composition.

<Frame>
  <img src="https://cdn.pickcel.com/images/pickcel-docs/delete-composition/dc-07-schedules-filtered-list.tsqyAiM54WFj.png" alt="Publish Schedules tab filtered to show only the schedule that uses the selected composition" />
</Frame>

<Info>
  The **Schedules** column only counts schedules. Quickplays and default-composition assignments don't appear there, you'll find those from the error message when you attempt the delete.
</Info>

## Remove the references, then delete

<Steps>
  <Step title="Delete the schedule">
    Go to **Publish**, open the **Schedules** tab, click the **⋯** menu on the schedule, and choose **Delete**. Confirm in the **Delete schedule?** dialog.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/delete-composition/dc-08-schedule-menu-delete.YEwfjUjwFcS3.png" alt="Publish Schedules tab with the three-dot menu open showing View Details, Edit, Assign Screens, Duplicate, and Delete" />
    </Frame>

    <br />

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/delete-composition/dc-09-delete-schedule-dialog.0bAoJqFVvb8m.png" alt="Delete schedule confirmation dialog naming the schedule that will be permanently deleted" />
    </Frame>

    Deleting a schedule removes it from every screen it was assigned to. If you want to keep the schedule and only drop this one composition, use **Edit** instead and remove the composition from its day sequence. See [Schedule](/schedule-and-publish/v5/schedule).
  </Step>

  <Step title="Delete the Quickplay">
    Still in **Publish**, open the **Quickplay** tab, click the **⋯** menu, and choose **Delete**. Confirm in the **Delete quick play?** dialog. This removes it from every screen it was pushed to.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/delete-composition/dc-10-quickplay-menu-delete.YSVs05ZPcgkl.png" alt="Publish Quickplay tab with the three-dot menu open showing View Details and Delete" />
    </Frame>

    See [Quickplay](/schedule-and-publish/v5/quick-play) for the full walkthrough.
  </Step>

  <Step title="Change the screen's default composition">
    Open **Screen**, click the screen named in the error, and switch to the **Content** tab. On the **Default Composition** card, click **Change**.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/delete-composition/dc-11-screen-content-default.0rHMO24MXbJ6.png" alt="Screen Content tab showing the Active Schedule, Play Now, and Default Composition cards" />
    </Frame>

    Pick a different composition and click **Set Default**. Repeat for every screen listed in the error.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/delete-composition/dc-12-set-default-composition.RGKjdfZnsg8e.png" alt="Set Default Composition dialog with the list of compositions and a radio button for each" />
    </Frame>

    <Warning>
      This picker only lists compositions from your **Composition** module. The **Organisation Default Composition** (**Settings → Default Content**) isn't in the list, so once you point a screen at a specific composition you can't switch it back to the organisation default from this screen. Pick the composition you actually want that screen to fall back to.
    </Warning>
  </Step>

  <Step title="Delete the composition">
    Go back to **Content → Composition** and repeat the delete. With every reference cleared, the composition is removed.
  </Step>
</Steps>

<Note>
  **Using the earlier console (v4)?** The steps are the same, only the labels differ, **Quick Play** is two words, the menus are reached from the **three dots** rather than **⋯**, and you confirm with **Yes, Delete**. See the [v4 publish guide](/schedule-and-publish/publish-v4).
</Note>

## Related

* [Edit a Composition](/compositions/edit-composition), change a composition instead of deleting it
* [Schedule](/schedule-and-publish/v5/schedule), edit or delete a schedule
* [Quickplay](/schedule-and-publish/v5/quick-play), stop content pushed instantly to a screen
* [Default Composition](/schedule-and-publish/default-composition), set what a screen plays when nothing is scheduled
