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

# Setting key times on a gig

> Open the key times editor, set a time per day, handle times after midnight, add notes, and see what happens to key times when you copy, move or shorten a gig.

A gig keeps one time per key time per gig day, in the gig's time zone. When the gig has a run of show, those times come from named items (see [Key times from run of show items](https://docs.soundchecklive.io/features/gigs/run-of-show/key-times/items.md)). The key times editor shows them all in one place and lets you change them without hunting through the schedule.

![Key times dialog with a line per key time, its time, the After midnight switch and an optional note](https://mintcdn.com/soundchecklive/DQsOfwUk5leizXB5/images/run-of-show/key-times-editor-light.png?fit=max\&auto=format\&n=DQsOfwUk5leizXB5\&q=85\&s=a69ed3002481bbd56e915603ebeaa74b)

## Opening the key times editor

On the web, open the gig and use either of these:

* The **⋮** menu of the gig's **Run of Show** tab, then **Key times**.
* The **Schedule** toolbar, next to **Undo** and **Redo**: **Key times**.

The editor opens in a dialog titled **Key times**. Its subheading names your [featured key times](https://docs.soundchecklive.io/features/gigs/run-of-show/key-times/organization-list.md#featured-key-times) and reminds you that they show up highlighted in the run of show.

### The Overview tab

When the gig's **Overview** shows the Run of Show section, that section lists the key times, grouped by day on a multi-day gig.

When your organization doesn't use Run of Show, or the Run of Show section is hidden, the **Key times** card is on the **Overview** tab instead, with **Add** or **Edit**.

## Using the editor

The editor has one line per key time.

| Field | What it holds |
| - | - |
| **What** | Which key time this line is, picked from your organization's list. |
| **Day** | Which gig day it's on. It shows only on a multi-day gig. |
| **Time** | The clock time, in the gig's time zone. |
| **After midnight** | Keeps a time after midnight on the night it belongs to. |
| **Note** | An optional note of up to 500 characters, such as *east gate*. |

* The buttons under the list add the featured key times you have not set yet. **Add key time** adds any other key time.
* The trash button on a line removes it.
* Choose **Save**. Soundcheck shows **Key times saved**.

> [!WARNING]
>
> Saving replaces the gig's whole set, so a key time you remove is deleted.

If you close the dialog with unsaved changes, Soundcheck asks **Discard key time changes?** before it throws them away.

### When the gig has a run of show

The editor and the run of show stay in step:

* Changing a time moves the earliest item with that key time to the new time.
* Removing a key time removes its named items.
* Adding a key time adds an item with that name to the latest main schedule section that has started by then. On a day with no section, the key time is saved on its own.

See [Key times from run of show items](https://docs.soundchecklive.io/features/gigs/run-of-show/key-times/items.md).

## Times after midnight

A time after midnight, like a 1:00 AM curfew, stays on the night it belongs to. Set it on that day and turn on **After midnight**. Lists show it with **(+1 day)** after the time.

## Multi-day gigs

Each key time can be set once per gig day. A new line in the editor starts on the key time's default day: load in on the first day and load out on the last day. Every other key time starts on the same day as the line above it, or on the first day. Change the **Day** to move it. See [The built-in key times](https://docs.soundchecklive.io/features/gigs/run-of-show/key-times/organization-list.md#the-built-in-key-times).

## Pasting key times

To set key times from a call sheet or an email, paste them:

* Above the run of show **List** view, choose **Paste key times**.
* On the **Key times** card, choose **Paste data**.

See [Pasting key times](https://docs.soundchecklive.io/features/gigs/run-of-show/importing.md#pasting-key-times) and [Times that fill in on their own](https://docs.soundchecklive.io/features/gigs/run-of-show/key-times/synced-times.md).

## Copying a gig

Duplicating a gig copies its key times and each section's link to a key time.

## Moving a gig

Key times stay on the same day of the run when you move a gig: a load in on the first day is still on the first day after a reschedule.

If you shorten a gig, key times on the removed days are hidden. They come back if you extend the gig again.

## Who can change key times

* Gig managers use the key times editor and the **Key times** card.
* Anyone who can edit the run of show can mark items as key times, which sets the gig's key times. See [Roles and permissions](https://docs.soundchecklive.io/settings/team/roles-permissions.md).
* Everyone on the gig can see its key times.

## For agents

The `get_event_key_times` MCP tool reads a gig's key times, and `set_event_key_times` replaces the whole set. The API is `GET` and `PUT /api/v1/events/{event_id}/key-times`.

Like the editor, `set_event_key_times` replaces the whole set, so send every key time you want to keep.

## Related

> [card] [Key times](https://docs.soundchecklive.io/features/gigs/run-of-show/key-times.md)
>
> Start here.

> [card] [Key times from run of show items](https://docs.soundchecklive.io/features/gigs/run-of-show/key-times/items.md)
>
> How items set the times.

> [card] [Multi-day gigs](https://docs.soundchecklive.io/features/gigs/run-of-show/multi-day.md)
>
> Days in the run of show.


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