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

# Templates import fields

> Import file fields (version 2.0) for task templates, team templates and run of show templates, with an example for each.

These are the fields for task templates, team templates and run of show templates. How to read a row, the fields at the top of the file and the other records are in [Import file fields](https://docs.soundchecklive.io/features/imports/import-format-reference.md). Every field here is Stable for version 2.x.

***

## Task templates (`checklist_templates[]`)

Reusable task lists the org starts gig checklists from. Give a record a `ref` (any short name, such as `main-stage`) so other records in the same file can point at it. A template matches the org's template with the same name, ignoring case. A matched template is not changed. `external_id` is kept for reference and does not match a record.

| Field | Type | Required | Status | Notes |
| - | - | - | - | - |
| `checklist_templates[].ref` | string | | Stable | Name for this task template inside the document. A workspace export writes the record's ID here, so importing that export back into the same workspace matches each task template to its own record before it looks at names. |
| `checklist_templates[].external_id` | string | | Stable | The task template's ID in the source system, kept for reference. |
| `checklist_templates[].name` | string | Yes | Stable | Task template name. |
| `checklist_templates[].default` | boolean | | Stable | New gigs start from it. Import never moves the default away from another template. |
| `checklist_templates[].phases[].title` | string | Yes | Stable | Template phase. |
| `checklist_templates[].phases[].kind` | string | | Stable | One of \{options}. A template has at most one UNCATEGORIZED phase. One of `STANDARD`, `UNCATEGORIZED`. |
| `checklist_templates[].phases[].tasks[].title` | string | Yes | Stable | Template task. |
| `checklist_templates[].phases[].tasks[].notes` | string | | Stable | Template task notes. |
| `checklist_templates[].phases[].tasks[].due_offset_days` | integer ≥ -2147483648 | | Stable | Days from the gig date the task is due; negative is before the gig. |
| `checklist_templates[].provenance.catalog_key` | string | | Stable | The Soundcheck starter catalog entry this task template came from. Import matches an org task template with the same key before it looks at names, and stores the key on a new one. |
| `checklist_templates[].provenance.catalog_version` | integer ≥ 1 | | Stable | The release of that catalog entry. Stored on a new task template with the key. |

### Example: task templates

A task template with two phases.

```json theme={null}
{
  "schema_version": "2.0",
  "source": {
    "type": "PASTE",
    "name": "task-templates"
  },
  "checklist_templates": [
    {
      "ref": "wedding-prep",
      "name": "Wedding prep",
      "default": true,
      "phases": [
        {
          "title": "Two weeks out",
          "tasks": [
            {
              "title": "Confirm timeline",
              "due_offset_days": -14
            },
            {
              "title": "Send crew call sheet",
              "due_offset_days": -7
            }
          ]
        },
        {
          "title": "Show day",
          "tasks": [
            {
              "title": "Load in",
              "due_offset_days": 0
            }
          ]
        }
      ]
    }
  ]
}
```

***

## Team templates (`staffing_plans[]`)

Reusable staffing plans: seats per position and a house labor call per department. Applying one to a gig puts its seats on the gig as draft shifts and its departments on the gig labor call. Give a record a `ref` (any short name, such as `main-stage`) so other records in the same file can point at it. A template matches the org's template with the same name, ignoring case. A matched template is not changed. A position is matched to the org's active position with the same name; a slot whose position the org does not have is left out. `external_id` is kept for reference and does not match a record.

| Field | Type | Required | Status | Notes |
| - | - | - | - | - |
| `staffing_plans[].ref` | string | | Stable | Name for this team template inside the document. A workspace export writes the record's ID here, so importing that export back into the same workspace matches each template to its own record before it looks at names. |
| `staffing_plans[].external_id` | string | | Stable | The template's ID in the source system, kept for reference. |
| `staffing_plans[].name` | string | Yes | Stable | Team template name. |
| `staffing_plans[].description` | string | | Stable | Team template description. |
| `staffing_plans[].category` | string | | Stable | Team template category. |
| `staffing_plans[].positions[].position` | string | Yes | Stable | The name of one of the org's active positions. |
| `staffing_plans[].positions[].seats` | number | | Stable | How many people the slot needs, from 1 to 50. Defaults to 1. |
| `staffing_plans[].positions[].required` | boolean | | Stable | Whether the slot must be filled for the gig to be fully staffed. Defaults to true. |
| `staffing_plans[].positions[].section` | string | | Stable | The section of the slot's position. When the org has more than one position with the slot's name, the one in this section is used. |
| `staffing_plans[].labor_lines[].department` | string | Yes | Stable | Team template department. |
| `staffing_plans[].labor_lines[].load_in_call` | string | | Stable | 24-hour HH:MM in the gig timezone. |
| `staffing_plans[].labor_lines[].load_in_hands` | number | | Stable | A headcount of local hands. Defaults to 0. |
| `staffing_plans[].labor_lines[].show_call` | string | | Stable | 24-hour HH:MM in the gig timezone. |
| `staffing_plans[].labor_lines[].show_hands` | number | | Stable | Defaults to 0. |
| `staffing_plans[].labor_lines[].load_out_call` | string | | Stable | 24-hour HH:MM in the gig timezone. A call earlier than the show call falls on the next morning. |
| `staffing_plans[].labor_lines[].load_out_hands` | number | | Stable | Defaults to 0. |
| `staffing_plans[].labor_lines[].notes` | string | | Stable | Team template notes. |
| `staffing_plans[].provenance.catalog_key` | string | | Stable | The Soundcheck starter catalog entry this team template came from. Import matches an org team template with the same key before it looks at names, and stores the key on a new one. |
| `staffing_plans[].provenance.catalog_version` | integer ≥ 1 | | Stable | The release of that catalog entry. Stored on a new team template with the key. |

### Example: team templates

A team template with two positions and a house labor call line.

```json theme={null}
{
  "schema_version": "2.0",
  "source": {
    "type": "PASTE",
    "name": "team-templates"
  },
  "staffing_plans": [
    {
      "name": "Arena crew",
      "category": "House",
      "positions": [
        {
          "position": "FOH Engineer"
        },
        {
          "position": "Stagehand",
          "seats": 4
        }
      ],
      "labor_lines": [
        {
          "department": "Stagehands",
          "load_in_call": "09:00",
          "load_in_hands": 8,
          "load_out_call": "23:00",
          "load_out_hands": 8
        }
      ]
    }
  ]
}
```

***

## Run of show templates (`run_of_show_templates[]`)

Reusable run of show outlines a gig starts from. Times are relative: a clock time of day or minutes from the template anchor, never a date, so a template fits any gig. Give a record a `ref` (any short name, such as `main-stage`) so other records in the same file can point at it. A template matches the org template with the same `provenance.catalog_key`, then the one with the same name, ignoring case. A matched template is not changed. A cue audience position is matched to the org active position with the same name; one the org does not have is left out. A cue song is matched to the org song with the same title and artist; one the org does not have is left out. File attachments are not carried. `external_id` is kept for reference and does not match a record.

| Field | Type | Required | Status | Notes |
| - | - | - | - | - |
| `run_of_show_templates[].ref` | string | | Stable | Name for this template inside the document. A workspace export writes the record's ID here, so importing that export back into the same workspace matches each template to its own record before it looks at names. |
| `run_of_show_templates[].external_id` | string | | Stable | The template's ID in the source system, kept for reference. |
| `run_of_show_templates[].name` | string | Yes | Stable | Run of show template name. |
| `run_of_show_templates[].description` | string | | Stable | Run of show template description. |
| `run_of_show_templates[].default` | boolean | | Stable | New gigs start from it. Import never moves the default away from another template. |
| `run_of_show_templates[].time_anchor_minutes` | integer 0–1439 | | Stable | The clock time, in minutes after midnight, that offsets count from. Required when any section or cue gives an offset. |
| `run_of_show_templates[].provenance.catalog_key` | string | | Stable | The Soundcheck starter catalog entry this run of show template came from. Import matches an org run of show template with the same key before it looks at names, and stores the key on a new one. |
| `run_of_show_templates[].provenance.catalog_version` | integer ≥ 1 | | Stable | The release of that catalog entry. Stored on a new run of show template with the key. |
| `run_of_show_templates[].sections[].title` | string | | Stable | Template section. |
| `run_of_show_templates[].sections[].day_offset` | integer 0–365 | | Stable | Whole days after the gig start date (0 is the first day). |
| `run_of_show_templates[].sections[].start_clock_minutes` | integer 0–1439 | | Stable | Start as minutes after midnight on its gig day, for a clock-timed entry. |
| `run_of_show_templates[].sections[].end_clock_minutes` | integer 0–1439 | | Stable | End as minutes after midnight, after the start clock. For a window past midnight, give end\_offset\_minutes instead. |
| `run_of_show_templates[].sections[].start_offset_minutes` | integer ≥ -2147483648 | | Stable | Start as minutes after the template anchor (time\_anchor\_minutes); negative is before it. Used when there is no start clock. |
| `run_of_show_templates[].sections[].end_offset_minutes` | integer ≥ -2147483648 | | Stable | End as minutes after the template anchor. |
| `run_of_show_templates[].sections[].notes` | string | | Stable | Template section notes. |
| `run_of_show_templates[].sections[].segment_kind` | string | | Stable | What the section is: any of CEREMONY \| COCKTAILS \| RECEPTION \| DINNER \| DANCING \| AFTER\_PARTY \| OTHER \| SOUND\_CHECK \| LOAD\_IN \| REHEARSAL \| DOORS \| SHOW \| INTERMISSION \| LOAD\_OUT. |
| `run_of_show_templates[].sections[].key_time_kind` | string | | Stable | The gig key time this section sets, such as doors. |
| `run_of_show_templates[].sections[].track` | string | | Stable | Template section track. |
| `run_of_show_templates[].sections[].color` | string | | Stable | Template section color. |
| `run_of_show_templates[].sections[].booking_state` | string | | Stable | Any of BOOKED \| CONTEXT\_ONLY. Defaults to BOOKED. |
| `run_of_show_templates[].sections[].location` | string | | Stable | Template section location. |
| `run_of_show_templates[].sections[].ensemble` | string | | Stable | Template section ensemble. |
| `run_of_show_templates[].sections[].piece_count` | integer 0–99 | | Stable | Template section pieces. |
| `run_of_show_templates[].sections[].vocal_count` | integer 0–99 | | Stable | Template section vocals. |
| `run_of_show_templates[].sections[].gear_notes` | string | | Stable | Up to 2000 characters. |
| `run_of_show_templates[].sections[].sort_order` | integer ≥ 0 | | Stable | Position of the section in the template. Defaults to its place in the list. |
| `run_of_show_templates[].sections[].cues[].title` | string | | Stable | Template cue. |
| `run_of_show_templates[].sections[].cues[].item_type` | string | | Stable | One of \{options}. Defaults to general. One of `general`, `song`, `break`, `announcement`. |
| `run_of_show_templates[].sections[].cues[].timing_mode` | string | | Stable | How the cue is timed: CLOCK \| SEGUE \| ON\_CUE. ON\_CUE needs a timing\_label. |
| `run_of_show_templates[].sections[].cues[].timing_label` | string | | Stable | Text shown in place of a clock time for an ON\_CUE cue. Up to 120 characters. |
| `run_of_show_templates[].sections[].cues[].start_clock_minutes` | integer 0–1439 | | Stable | Start as minutes after midnight on its gig day, for a clock-timed entry. |
| `run_of_show_templates[].sections[].cues[].end_clock_minutes` | integer 0–1439 | | Stable | End as minutes after midnight, after the start clock. For a window past midnight, give end\_offset\_minutes instead. |
| `run_of_show_templates[].sections[].cues[].start_offset_minutes` | integer ≥ -2147483648 | | Stable | Start as minutes after the template anchor (time\_anchor\_minutes); negative is before it. Used when there is no start clock. |
| `run_of_show_templates[].sections[].cues[].end_offset_minutes` | integer ≥ -2147483648 | | Stable | End as minutes after the template anchor. |
| `run_of_show_templates[].sections[].cues[].duration_minutes` | integer ≥ 0 | | Stable | Minimum length of the cue in minutes. |
| `run_of_show_templates[].sections[].cues[].duration_max_minutes` | integer 0–1440 | | Stable | Longest the cue may run in minutes. Must be at least duration\_minutes. |
| `run_of_show_templates[].sections[].cues[].notes` | string | | Stable | Template cue notes. |
| `run_of_show_templates[].sections[].cues[].instructions` | string | | Stable | Up to 4000 characters. |
| `run_of_show_templates[].sections[].cues[].announcement` | string | | Stable | Template cue announcement. |
| `run_of_show_templates[].sections[].cues[].location` | string | | Stable | Template cue location. |
| `run_of_show_templates[].sections[].cues[].ensemble` | string | | Stable | Template cue ensemble. |
| `run_of_show_templates[].sections[].cues[].tentative` | boolean | | Stable | Template cue tentative. |
| `run_of_show_templates[].sections[].cues[].key_time_kind` | string | | Stable | The gig key time this cue sets, such as doors. |
| `run_of_show_templates[].sections[].cues[].linked_to_previous` | string | | Stable | Links the cue to the cue right before it in its section: SEGUE \| GROUP. SEGUE starts it when that cue ends; GROUP moves the two together. Ignored on the first cue of a section. |
| `run_of_show_templates[].sections[].cues[].playback_source` | string | | Stable | Where the cue audio plays from: LIVE \| TRACK \| DS\_IPAD \| OTHER. |
| `run_of_show_templates[].sections[].cues[].note_roles` | list of strings | | Stable | Who the cue note is for: any of SOUND \| BAND\_LEADER \| PLANNER \| MUSICIANS. |
| `run_of_show_templates[].sections[].cues[].audience_positions` | list of strings | | Stable | Names of the org positions that see this cue. A name the org does not have is left out. |
| `run_of_show_templates[].sections[].cues[].sort_order` | integer ≥ 0 | | Stable | Position of the cue in the template. Defaults to its place in the list. |
| `run_of_show_templates[].sections[].cues[].speakers[].name` | string | Yes | Stable | Template cue speaker. |
| `run_of_show_templates[].sections[].cues[].speakers[].relationship` | string | | Stable | Template cue speaker relationship. |
| `run_of_show_templates[].sections[].cues[].speakers[].minutes` | integer 0–600 | | Stable | Template cue speaker minutes. |
| `run_of_show_templates[].sections[].cues[].songs[].title` | string | Yes | Stable | Title of a song in the org repertoire. A song the org does not have is left out. |
| `run_of_show_templates[].sections[].cues[].songs[].artist` | string | | Stable | Template cue song artist. |
| `run_of_show_templates[].cues[].title` | string | | Stable | Template cue. |
| `run_of_show_templates[].cues[].item_type` | string | | Stable | One of \{options}. Defaults to general. One of `general`, `song`, `break`, `announcement`. |
| `run_of_show_templates[].cues[].timing_mode` | string | | Stable | How the cue is timed: CLOCK \| SEGUE \| ON\_CUE. ON\_CUE needs a timing\_label. |
| `run_of_show_templates[].cues[].timing_label` | string | | Stable | Text shown in place of a clock time for an ON\_CUE cue. Up to 120 characters. |
| `run_of_show_templates[].cues[].start_clock_minutes` | integer 0–1439 | | Stable | Start as minutes after midnight on its gig day, for a clock-timed entry. |
| `run_of_show_templates[].cues[].end_clock_minutes` | integer 0–1439 | | Stable | End as minutes after midnight, after the start clock. For a window past midnight, give end\_offset\_minutes instead. |
| `run_of_show_templates[].cues[].start_offset_minutes` | integer ≥ -2147483648 | | Stable | Start as minutes after the template anchor (time\_anchor\_minutes); negative is before it. Used when there is no start clock. |
| `run_of_show_templates[].cues[].end_offset_minutes` | integer ≥ -2147483648 | | Stable | End as minutes after the template anchor. |
| `run_of_show_templates[].cues[].duration_minutes` | integer ≥ 0 | | Stable | Minimum length of the cue in minutes. |
| `run_of_show_templates[].cues[].duration_max_minutes` | integer 0–1440 | | Stable | Longest the cue may run in minutes. Must be at least duration\_minutes. |
| `run_of_show_templates[].cues[].notes` | string | | Stable | Template cue notes. |
| `run_of_show_templates[].cues[].instructions` | string | | Stable | Up to 4000 characters. |
| `run_of_show_templates[].cues[].announcement` | string | | Stable | Template cue announcement. |
| `run_of_show_templates[].cues[].location` | string | | Stable | Template cue location. |
| `run_of_show_templates[].cues[].ensemble` | string | | Stable | Template cue ensemble. |
| `run_of_show_templates[].cues[].tentative` | boolean | | Stable | Template cue tentative. |
| `run_of_show_templates[].cues[].key_time_kind` | string | | Stable | The gig key time this cue sets, such as doors. |
| `run_of_show_templates[].cues[].playback_source` | string | | Stable | Where the cue audio plays from: LIVE \| TRACK \| DS\_IPAD \| OTHER. |
| `run_of_show_templates[].cues[].note_roles` | list of strings | | Stable | Who the cue note is for: any of SOUND \| BAND\_LEADER \| PLANNER \| MUSICIANS. |
| `run_of_show_templates[].cues[].audience_positions` | list of strings | | Stable | Names of the org positions that see this cue. A name the org does not have is left out. |
| `run_of_show_templates[].cues[].sort_order` | integer ≥ 0 | | Stable | Position of the cue in the template. Defaults to its place in the list. |
| `run_of_show_templates[].cues[].speakers[].name` | string | Yes | Stable | Template cue speaker. |
| `run_of_show_templates[].cues[].speakers[].relationship` | string | | Stable | Template cue speaker relationship. |
| `run_of_show_templates[].cues[].speakers[].minutes` | integer 0–600 | | Stable | Template cue speaker minutes. |
| `run_of_show_templates[].cues[].songs[].title` | string | Yes | Stable | Title of a song in the org repertoire. A song the org does not have is left out. |
| `run_of_show_templates[].cues[].songs[].artist` | string | | Stable | Template cue song artist. |

### Example: run of show templates

A run of show template with an anchor at 17:00, one section timed from the anchor and an unsectioned cue on a clock time.

```json theme={null}
{
  "schema_version": "2.0",
  "source": {
    "type": "PASTE",
    "name": "run-of-show-templates"
  },
  "run_of_show_templates": [
    {
      "name": "Wedding reception",
      "time_anchor_minutes": 1020,
      "sections": [
        {
          "title": "Cocktail hour",
          "segment_kind": "COCKTAILS",
          "start_offset_minutes": 0,
          "end_offset_minutes": 60,
          "cues": [
            {
              "title": "Doors",
              "start_offset_minutes": 0
            },
            {
              "title": "Toasts",
              "timing_mode": "ON_CUE",
              "timing_label": "After the entrance",
              "speakers": [
                {
                  "name": "Best man",
                  "minutes": 5
                }
              ],
              "audience_positions": [
                "Band Leader"
              ]
            }
          ]
        }
      ],
      "cues": [
        {
          "title": "Load out",
          "start_clock_minutes": 1380
        }
      ]
    }
  ]
}
```


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