# What is a playlist?

A playlist shows dashboards and goal lists **one after another**, like slides.
Page through it yourself in a meeting, or leave it rotating on a screen on
the wall.

## What it represents

A playlist is an order, and nothing more. It holds no numbers and no cards of
its own: each slide is a dashboard or a goal list that already exists, shown
live. Change a dashboard and the playlist shows the change. Rename one and
the playlist follows it. Delete one and it leaves the playlist.

It's the last layer of the stack: metrics become cards, cards become
dashboards, and a playlist decides what a room sees and for how long.

## How it's set up

**Dashboards → Playlists → New playlist**:

1. **Name it.**
2. Under **Playing**, set the defaults for the show: the **seconds on each
   slide**, whether it **loops** and whether it **plays when opened**.
3. Under **Slides, in order**, pick a dashboard or a goal list and choose
   **Add**. Repeat for each one. Reorder with ↑ and ↓.
4. Each slide says **Default** while it uses the show's seconds. Click it to
   give that slide its own time; **↺** puts it back. A slide can also be
   pinned to its own period (say, *last 7 days*) for this playlist only.
5. For a goal list, choose what the slide shows: **Goals now**, **Last week**
   (the week just ended, as it was saved) or **Week over week**.

## How to use it

**In a meeting.** Open the playlist and step through it. The bar at the top
has previous, play or pause and next, with one step per slide; click a step
to jump to it.

| Key | Does |
|---|---|
| → or Page Down | Next slide |
| ← or Page Up | Previous slide |
| Space or K | Play or pause |
| Home, End | First, last slide |
| F | Full screen |

**On a wall screen.** **Wall screen** on a playlist's page opens it with the
site's menus hidden and already playing. That address is the one to put on a
TV.

**As a link.** The address follows along as it plays, so a copied link opens
on the same slide. You can also add `?slide=3` to open on the third slide, or
`?seconds=20` to change the timing for one viewing.

## Good to know

- **It pauses when you need it to.** Clicking into a card to read its rows
  pauses the playlist, and so does switching to another browser tab.
- **Everyone sees only what they may open.** A slide the viewer can't open is
  skipped, not shown blank. The playlists list says when some of a playlist's
  slides are hidden from you.
- **Personal or shared.** A personal playlist can hold your own dashboards
  and goal lists and shared ones. A shared playlist holds only shared ones.
- **A weekly meeting in one playlist:** the team dashboard first, then the
  goal list as *Goals now*, *Last week* and *Week over week*.