# Cue List

The Cue List is an alternative to the Timeline for shows where playback is driven by discrete cues rather than a continuous time ruler — typical in theatre, corporate events, and touring.

![Cue list view](/files/i2bEfMjapqUBGYBEPjcU)

## Switching to Cue List Mode

In the Sub-header bar below the canvas, click the **CueList** tab to switch the bottom panel to cue view.

## Anatomy of a Cue

| Property        | Description                                                            |
| --------------- | ---------------------------------------------------------------------- |
| **Number**      | Auto-incremented integer; can be manually set (e.g. `101`, `101.5`)    |
| **Name**        | Human-readable label shown in the operator view                        |
| **Action**      | What the cue does (see below)                                          |
| **Pre-wait**    | Delay between the previous cue finishing and this cue firing (seconds) |
| **Post-wait**   | Delay after this cue's action before auto-following the next (seconds) |
| **Auto-follow** | When enabled, the next cue fires automatically after `post-wait`       |
| **Hot Key**     | Optional keyboard shortcut for direct triggering                       |

## Cue Actions

| Action             | Description                                              |
| ------------------ | -------------------------------------------------------- |
| `Go to timecode`   | Jump the playhead to a specific timecode and play        |
| `Play`             | Resume from current position                             |
| `Stop`             | Stop playback                                            |
| `Fade to black`    | Fade all outputs to black over a specified duration      |
| `Load composition` | Switch to a different composition on one or more screens |
| `Set volume`       | Ramp audio to a target level                             |
| `Fire OSC`         | Send an OSC message to an external device                |

## Running a Show with Cues

1. In the [Operator Control view](/v3/user-interface/control-view.md), cues appear as a vertically scrolling list.
2. The **current cue** is highlighted.
3. Press **Space** or the **Go** button to execute the highlighted cue and advance.
4. The list scrolls automatically to keep the next cue visible.

## Creating Cues

1. Click **+ Cue** in the cue list toolbar.
2. Fill in the properties in the inline editor.
3. Drag the cue row to reorder it.
4. Right-click a cue for **Duplicate**, **Delete**, or **Insert Before/After** options.

## Importing and Exporting Cues

Cues are saved inside the `.vpp` project file. You can also export the cue list as a CSV file (**Cue List menu → Export CSV**) to share it with stage managers or import into another show.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.exaplay.one/v3/user-interface/cuelist.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.