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

# Setlists

> Start here: songs, setlists, sets, song types, acts and music requests, how they fit into the run of show, and a guided first set. Every part has its own detailed page.

**Setlists** is the music side of a gig: the songs your organization can play, the setlists you reuse from show to show, and the sets each gig actually plays. It lives inside the [Run of Show](https://docs.soundchecklive.io/features/gigs/run-of-show.md). The setlist is *what you're playing*. The run of show is *everything that happens, and when*, with each set slotted into its place in the night. Because a set sits in its slot, the setlist and the schedule can't drift apart.

Setlists does a lot, so these docs are split up. This page covers the ideas, how sets work in the run of show, and a first walkthrough. Each area then has its own page with the full detail.

![Setlists tab on the Run of Show page with a reusable setlist and its set and song counts](https://mintcdn.com/soundchecklive/EpuwxNqbqHAHt986/images/setlists/overview-setlists-light.png?fit=max\&auto=format\&n=EpuwxNqbqHAHt986\&q=85\&s=c778f06cd834235ec99f63e74e6ee2b7)

## Where to find it

| What | Where |
| - | - |
| The song library | **Show prep → Documents**, then **Songs** (`/assets?view=songs`). |
| Saved setlists | The **Setlists** tab of the **Run of Show** page (**Show prep → Run of Show**). Before your organization [switches to Run of Show](#after-your-organization-switches-to-run-of-show), the **Setlists** page under **Show prep** lists them too. |
| A gig's sets | The gig's **Run of Show** tab: a set is a song item in **List** and **Schedule**, and the **Setlist** view lists every set for the stage. |
| Music requests | Below the sets in the gig's run of show **Setlist** view. |
| Song types | **Types** in the song library toolbar. |
| Acts | The **Acts** page in organization settings. |

In the mobile app, crew read a gig's sets in its run of show. See [Setlists on mobile](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/mobile.md).

## The building blocks

Learn these ideas first. Everything else builds on them.

| Idea | What it is | Example |
| - | - | - |
| **Song** | One entry in your organization's song library. It has a title and, if you like, an artist, length, key, tempo, notes, type, acts and media links. One song can sit in any number of setlists and sets. | *Take Five*, 5:24, Eb minor |
| **Song library** | Your organization's catalog of performable songs, in **Documents → Songs**. Every setlist and set picks from it. | The 400 songs your band can play |
| **Setlist** | A saved, reusable program of songs, split into sets, with no times. Build it once and add it to any gig. | *Wedding reception* |
| **Set** | A group of songs played together. In a saved setlist it's a section of the setlist. On a gig it's one **song item** in the run of show, with one time for the whole set. | *Set 1*, *Dinner set*, *Encore* |
| **Song type** | A coloured tag for when you play a song. The colour shows next to the song everywhere. | *First dance*, *Dinner* |
| **Act** | A band, DJ or performer you book. Tag songs to the acts that play them, so each act's sets start from its own songs. | *The Wedding Band* |
| **Music request** | A song, artist or genre the client asks for (**Must play**, **Yes**, **Off-list (to learn)**) or rules out (**Do not play**). | *Do not play: Chicken Dance* |
| **Music notes** | One card of notes for the band on each gig: segues, key changes, songs to skip. | *Segue Set 2 straight into the cake cut* |

### How it fits together

```
Song library (Documents → Songs)
├── Song: Take Five        Type: Dinner        Acts: The Jazz Trio
├── Song: At Last          Type: First dance   Acts: The Wedding Band
└── …

Saved setlist: "Wedding reception"        (Run of Show → Setlists tab)
├── Set: Cocktail hour      12 songs
├── Set: Dinner             15 songs
└── Set: Dancing            24 songs

Gig → Run of Show
└── Subsection: Reception
    ├── Song item: Cocktail hour     6:00 PM   12 songs from "Wedding reception"
    ├── Song item: Dinner            7:00 PM   15 songs
    └── Song item: Dancing           8:30 PM   24 songs
                                        ↑ music requests are checked against these
```

A song is stored once. Change its key in the library, and every setlist and set that uses it shows the new key.

## How a set works in the run of show

* A set is a **song item**. Its row in **List** is one row, however many songs it holds.
* A set's length comes from its songs. Adding a song pushes the items after it later.
* Songs come from one shared song library, the same one your saved setlists use.
* A set has a title, such as *Set 1* or *Dinner set*. A new set gets the next set number when you don't name it.

### Adding a setlist to an item

The quickest way to fill a set is to pick a whole setlist. In the **List** view:

**1. Open the item**

Click the item's **What** cell. The panel opens with its **Title**, **Notes** and **Songs**.

**2. Choose Add setlist**

Under **Songs**, choose **Add setlist**. One search list opens: **Search setlists and songs**.

**3. Pick a setlist**

**Setlists** come first: the gig's own setlists and your organization's saved setlists, each with its number of sets. Pick one.

**4. Check the result**

The item fills with that setlist's songs. If the setlist has more than one set, the extra sets become new items right below it, in order.

Picking a setlist works on any item. A *Break* or a *Note* row becomes a set when you fill it. If the item already had a title, it keeps it. Otherwise it takes the set's name.

Picking a setlist replaces the item's songs with the setlist's songs. A toast confirms what was added. If a set in the setlist has no songs, it's skipped and a message names it. If the whole setlist has no songs, nothing changes and a message says so.

> [!TIP]
>
> Saved setlists are fetched only when you open **Add setlist**, so the list may take a moment to fill on a large library. While it loads, the list reads **Loading saved setlists…**.

### Adding single songs

The same list shows songs below the setlists: the **Gig setlist** songs first, then the **Song library**. Ticking a song adds it to the item, and ticking it again removes it. Ticking a song on an item that isn't a set makes it a set and keeps its title.

Use single songs for a one-off, such as a request or a first dance. Use a setlist when you're placing a whole program.

When the client has sent [music requests](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/music-requests.md), requested songs are pinned in the song picker with their category, such as **Must play** or **Do not play**.

> [!NOTE]
>
> There is one control for songs in the **What** panel: **Add setlist**. The older separate **Pick a song** box is gone. To create a brand-new song while you build, open the item with **Open full details**.

### Building a set on the Schedule

On the **Schedule** view, click a song item to open its side sheet:

* Choose **Use a saved setlist** to fill the item from a setlist in your library, the same way as above.
* Add, remove and reorder the set's songs right in the sheet.

On the **Tracks** layout, each act has a lane. Use **Add set** under the lane, add the act's songs (they're listed first), and drag to reorder. A lane's menu can also add a saved setlist to that lane as sets. See [Building on the Schedule](https://docs.soundchecklive.io/features/gigs/run-of-show/schedule-view.md#act-lanes).

### Building a set in Details

From the **List** view, open a row's **⋯** menu and choose **Details…**. Pick the set's first song, then choose **Add song** under it to search the song library and grow it into a set. Drag to reorder, or remove a song. You can also add a new song to the library right from the picker.

### The Setlist view

**Setlist** is a big-type list of every set that has songs, without times, for printing or a stage monitor. Each set is labeled with its slot on the timeline. If you can edit the run of show, it's also a full set editor: add and remove songs, drag to reorder, **Add set**, **Use a saved setlist**, **Save as setlist**, **Re-sync**, **Paste data**, each set's **Ensemble**, **Pieces** and **Vocals**, and the gig's **Music notes**. See [The Setlist view](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/setlist-view.md).

## Your first set, step by step

This walkthrough takes you from an empty library to a set on a gig. It takes about ten minutes.

**1. Fill the song library**

Open **Documents → Songs**. Choose **Starter packs** to add songs for your kind of business, **Import from Spotify** to bring in an album, or **New song** to type one in. See [Adding songs in bulk](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/importing-songs.md).

**2. Add lengths and keys**

Click a few songs, choose **Edit song**, and fill in **Duration** and **Key**. A set's length is the sum of its songs, so a song with no length makes its set look shorter than it is. See [The song library](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/song-library.md).

**3. Save a setlist**

Go to **Show prep → Run of Show**, open the **Setlists** tab, and choose **New Setlist**. Name it, add songs to **Set 1** with **Browse Library**, use **Add New Set** for each further set, then choose **Save Setlist**. See [Building saved setlists](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/building-setlists.md).

**4. Put it on a gig**

Open a gig, choose the **Run of Show** tab and pick **List**. Click the **What** cell of the row where the music goes, choose **Add setlist**, and pick your setlist. Each set lands as its own item.

**5. Check it for the stage**

Switch to the **Setlist** view to see every set in big type. Add **Music notes** for the band below the sets.

> [!TIP]
>
> Tag songs to acts and give them types early. A set that names an act then offers that act's songs, and the type colours make a long set easy to scan.

## Pick the right page

> [card] [The song library](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/song-library.md)
>
> Add, edit, find, select and delete songs, with every field and media link.

> [card] [Adding songs in bulk](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/importing-songs.md)
>
> Starter packs, Spotify albums, Find a song, spreadsheets and show packets.

> [card] [Building saved setlists](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/building-setlists.md)
>
> The Setlists tab, the setlist builder, editing in place, duplicating and exporting.

> [card] [The Setlist view](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/setlist-view.md)
>
> The gig's stage list and set editor, Save as setlist, Re-sync, Paste data and Music notes.

> [card] [Song types](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/song-types.md)
>
> Colour-coded types for when you play a song.

> [card] [Acts and songs](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/acts.md)
>
> Tag songs to the acts that play them, and how pickers and act lanes use the tags.

> [card] [Music requests](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/music-requests.md)
>
> The client's must-play and do-not-play list, and requests your team enters.

> [card] [Works with](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/works-with.md)
>
> How Setlists connects to Run of Show, Acts, Documents, the client portal and Imports.

> [card] [Mobile](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/mobile.md)
>
> What the mobile app shows and what stays on the web.

> [card] [Troubleshooting](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/troubleshooting.md)
>
> Answers when something doesn't look right.

## Who can do what

| Action | Owner | Admin | Gig Coordinator | Member |
| - | :-: | :-: | :-: | :-: |
| See a gig's sets | ✓ | ✓ | ✓ | If on the gig |
| Edit a gig's sets in its run of show | ✓ | ✓ | ✓ | With run of show edit access |
| Create, edit and delete saved setlists | ✓ | ✓ | ✓ | No |
| Manage the song library and song types | ✓ | ✓ | ✓ | No |
| Add, rename and delete acts | ✓ | ✓ | No | No |

Once your organization has brought its setlists into Run of Show, the songs in a gig's set are run of show items, so whoever can edit the gig's run of show edits them: the gig lead, or anyone with the Run of Show role. Before that, editing a gig's setlist takes an Owner, Admin or Gig Coordinator. Owners, admins, finance members and gig coordinators can add [music requests](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/music-requests.md) by hand. See [Roles and permissions](https://docs.soundchecklive.io/settings/team/roles-permissions.md).

## After your organization switches to Run of Show

When an owner or admin [switches the organization to Run of Show](https://docs.soundchecklive.io/features/gigs/run-of-show/timeline-switch.md#switching-from-the-timeline), or later chooses **Bring setlists into Run of Show**, your setlists are copied:

* Each gig setlist becomes a section of that gig's Run of Show, one **song item** per set with its songs in order. Edit it in the gig's Run of Show **List** or **Setlist** view; viewers see the **Setlist** view as a read-only list for the stage.
* Each library setlist becomes a Run of Show template you can apply to any gig.
* Gig setlists become read-only: editing one, or attaching a setlist to a gig, is refused. An old link to a gig setlist opens that gig's Run of Show instead.
* The gig's old **Setlist** section and the mobile **Setlist** tab are hidden. Older versions of the mobile app still show each gig's sets, read from its Run of Show.
* **Setlists** leaves the sidebar. The old **Setlists** page sends you to the **Setlists** tab of the **Run of Show** page, and its old song library links open **Documents → Songs**.
* The original setlists are kept on our side as a backup.

Setlists that aren't tied to a gig stay editable on the **Setlists** tab. Library setlists that were copied into templates during the switch also appear there, next to their template copies. Deleting a setlist doesn't change gigs that already use its songs. See [Building saved setlists](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/building-setlists.md).

For the whole switch, its limits, and how to bring setlists over after an earlier switch, see [The day-of timeline and switching](https://docs.soundchecklive.io/features/gigs/run-of-show/timeline-switch.md).

### Linking a gig's sets to a setlist

On a gig's Run of Show **Setlist** view, editors can choose **Save as setlist** to save the gig's sets to the **Setlists** tab. The gig's sets stay linked to that setlist: each shows **From** and the setlist's name, with **Re-sync**. **Re-sync** replaces the songs in each linked set with that set's current songs from the setlist, and adds back any of its sets the gig no longer has. Any song changes you made to those sets on the gig are replaced; nothing syncs until you choose **Re-sync**. See [Save as setlist and Re-sync](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/setlist-view.md#save-as-setlist-and-re-sync).

### Music requests on the run-of-show Setlist view

Song requests no longer live on setlists. The client fills in the **Music requests** form, and your team can add requests that came in by email or phone. The gig's run-of-show **Setlist** view shows them below the sets: counts per category, the notes, each song's library match, and a warning when a run-of-show song matches a do-not-play request. Warnings never block a save. See [Music requests](https://docs.soundchecklive.io/features/gigs/run-of-show/setlists/music-requests.md).

## Related

> [card] [Run of Show](https://docs.soundchecklive.io/features/gigs/run-of-show.md)
>
> The schedule your sets live in.

> [card] [Templates](https://docs.soundchecklive.io/features/gigs/run-of-show/templates.md)
>
> Library setlists become templates after the switch.

> [card] [Setlists FAQ](https://docs.soundchecklive.io/features/gigs/run-of-show/faq.md)
>
> Short answers to common questions.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.