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

# Labels, gig types and offerings import fields

> Import file fields (version 2.0) for label groups, labels, gig types, offerings and packages, with an example for each.

These are the fields for label groups, labels, gig types, offerings and packages. 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.

***

## Label groups (`label_groups[]`)

Groups the org files its labels under. A label names its group with group\_ref. Give a record a `ref` (any short name, such as `main-stage`) so other records in the same file can point at it. A group matches the org's active group with the same name, ignoring case. A matched group is not changed. Built-in groups, such as gig type, are not exported or matched. `external_id` is kept for reference and does not match a record.

| Field | Type | Required | Status | Notes |
| - | - | - | - | - |
| `label_groups[].ref` | string | | Stable | Name for this label group inside the document, used by labels\[].group\_ref. A workspace export writes the record's ID here, so importing that export back into the same workspace matches each label group to its own record before it looks at names. |
| `label_groups[].external_id` | string | | Stable | The label group's ID in the source system, kept for reference. |
| `label_groups[].name` | string | Yes | Stable | Label group name. |
| `label_groups[].description` | string | | Stable | Label group description. |
| `label_groups[].selection` | string | | Stable | One of \{options}. A SINGLE group gives an item at most one of its labels. Import never takes a label off an item, so a label that would replace another one in a SINGLE group is left off, with a note. One of `SINGLE`, `MULTIPLE`. |
| `label_groups[].applies_to` | list of strings | | Stable | What the group's labels can be put on: EVENT, TASK, ASSET, SCHEDULE\_ITEM or CONTACT. Empty means anything. |

***

## Labels (`labels[]`)

The org's labels. Gigs and gig tasks name them in labels. Give a record a `ref` (any short name, such as `main-stage`) so other records in the same file can point at it. A label matches the org's active label with the same name in the same group, ignoring case. A matched label is not changed. `external_id` is kept for reference and does not match a record.

| Field | Type | Required | Status | Notes |
| - | - | - | - | - |
| `labels[].ref` | string | | Stable | Name for this label inside the document, used by events\[].labels and events\[].checklist\[].tasks\[].labels. A workspace export writes the record's ID here, so importing that export back into the same workspace matches each label to its own record before it looks at names. |
| `labels[].external_id` | string | | Stable | The label's ID in the source system, kept for reference. |
| `labels[].name` | string | Yes | Stable | Label name. |
| `labels[].group_ref` | ref → `label_groups[].ref` | | Stable | Label group. |
| `labels[].color` | string | | Stable | A hex color. Import picks one when it is missing. |
| `labels[].description` | string | | Stable | Label description. |
| `labels[].applies_to` | list of strings | | Stable | What the label can be put on: EVENT, TASK, ASSET, SCHEDULE\_ITEM or CONTACT. Empty means anything its group allows. |

### Example: labels

A label group, its labels, and a gig and one of its checklist tasks labelled with them.

```json theme={null}
{
  "schema_version": "2.0",
  "source": {
    "type": "PASTE",
    "name": "labels"
  },
  "label_groups": [
    {
      "ref": "priority",
      "name": "Priority",
      "selection": "SINGLE",
      "applies_to": [
        "EVENT",
        "TASK"
      ]
    }
  ],
  "labels": [
    {
      "ref": "vip",
      "name": "VIP",
      "group_ref": "priority",
      "color": "#7C3AED"
    },
    {
      "ref": "rush",
      "name": "Rush",
      "group_ref": "priority"
    }
  ],
  "events": [
    {
      "title": "Lee wedding",
      "event_date": "2026-09-12",
      "labels": [
        "vip"
      ],
      "checklist": [
        {
          "title": "Two weeks out",
          "tasks": [
            {
              "title": "Confirm timeline",
              "due_date": "2026-08-29",
              "assignee_email": "ada@example.com",
              "labels": [
                "rush"
              ]
            }
          ]
        }
      ]
    }
  ]
}
```

***

## Gig types (`event_types[]`)

The org's gig types: the built-in Event Type list that events\[].event\_type picks from. An entry matches the org's active gig type with the same name, ignoring case, spacing and a plural ending, and is not changed; any other entry is created before the gigs are written. A gig whose event\_type is the entry's name or one of its aliases gets the matched or created gig type's spelling.

| Field | Type | Required | Status | Notes |
| - | - | - | - | - |
| `event_types[].name` | string | Yes | Stable | Gig type name. |
| `event_types[].color` | string | | Stable | A hex color for a new gig type. Import picks one when it is missing. A matched gig type keeps its own color. |
| `event_types[].description` | string | | Stable | Gig type description. |
| `event_types[].aliases` | list of strings | | Stable | Other words the source uses for this gig type. A gig whose event\_type is one of them is imported with this gig type. |

### Example: gig types

Two gig types, one with the other spellings the source uses, and a gig that names it by one of them.

```json theme={null}
{
  "schema_version": "2.0",
  "source": {
    "type": "PASTE",
    "name": "gig-types"
  },
  "event_types": [
    {
      "name": "Wedding",
      "color": "#DB2777",
      "aliases": [
        "Weddings",
        "wedding reception"
      ]
    },
    {
      "name": "Corporate"
    }
  ],
  "events": [
    {
      "title": "Lee wedding",
      "event_date": "2026-09-12",
      "event_type": "Weddings"
    }
  ]
}
```

***

## Offerings (`offerings[]`)

What the org sells. A package line names one with offering\_ref. Give a record a `ref` (any short name, such as `main-stage`) so other records in the same file can point at it. An offering matches the org's offering with the same name, ignoring case. A matched offering is not changed. `external_id` is kept for reference and does not match a record.

| Field | Type | Required | Status | Notes |
| - | - | - | - | - |
| `offerings[].ref` | string | | Stable | Name for this offering inside the document, used by offering\_packages\[].lines\[].offering\_ref. A workspace export writes the record's ID here, so importing that export back into the same workspace matches each offering to its own record before it looks at names. |
| `offerings[].external_id` | string | | Stable | The offering's ID in the source system, kept for reference. |
| `offerings[].name` | string | Yes | Stable | Offering name. |
| `offerings[].description` | string | | Stable | Offering description. |
| `offerings[].category` | string | Yes | Stable | One of \{options}. One of `AUDIO`, `LIGHTING`, `VIDEO`, `LABOR`, `PACKAGE`, `VENUE_SERVICES`, `OTHER`. |
| `offerings[].unit` | string | | Stable | One of \{options}. Defaults to DAY. One of `EACH`, `HOUR`, `DAY`, `FLAT`. |
| `offerings[].sell_rate` | decimal | | Stable | What the org charges per unit. A new offering needs it. Workspace export includes it only for people with finance access, and import sets it only when the importer may edit finances. |
| `offerings[].cogs` | decimal | | Stable | What one unit costs the org. Workspace export includes it only for people with finance access, and import sets it only when the importer may edit finances. |
| `offerings[].invoice_label` | string | | Stable | Invoice label. |
| `offerings[].active` | boolean | | Stable | Offering active. |
| `offerings[].public` | boolean | | Stable | Offering on the storefront. |

### Example: offerings

Two offerings and a package that bundles them.

```json theme={null}
{
  "schema_version": "2.0",
  "source": {
    "type": "PASTE",
    "name": "offerings"
  },
  "offerings": [
    {
      "ref": "pa",
      "name": "Line array PA",
      "category": "AUDIO",
      "unit": "DAY",
      "sell_rate": 1200,
      "cogs": 300
    },
    {
      "ref": "tech",
      "name": "A1 engineer",
      "category": "LABOR",
      "unit": "HOUR",
      "sell_rate": 85
    }
  ],
  "offering_packages": [
    {
      "ref": "wedding",
      "name": "Wedding essentials",
      "deposit_pct": 50,
      "lines": [
        {
          "offering_ref": "pa",
          "quantity": 1
        },
        {
          "offering_ref": "tech",
          "quantity": 8,
          "rate_override": 80
        }
      ]
    }
  ]
}
```

***

## Packages (`offering_packages[]`)

Priced bundles of offerings the org quotes 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 package matches the org's package with the same name, ignoring case. A matched package is not changed. `external_id` is kept for reference and does not match a record.

| Field | Type | Required | Status | Notes |
| - | - | - | - | - |
| `offering_packages[].ref` | string | | Stable | Name for this package inside the document. A workspace export writes the record's ID here, so importing that export back into the same workspace matches each package to its own record before it looks at names. |
| `offering_packages[].external_id` | string | | Stable | The package's ID in the source system, kept for reference. |
| `offering_packages[].name` | string | Yes | Stable | Package name. |
| `offering_packages[].description` | string | | Stable | Package description. |
| `offering_packages[].deposit_pct` | decimal | | Stable | Between 0 and 100. Defaults to 50. |
| `offering_packages[].public` | boolean | | Stable | Package on the storefront. |
| `offering_packages[].lines[].offering_ref` | ref → `offerings[].ref` | Yes | Stable | Package offering. |
| `offering_packages[].lines[].quantity` | decimal | | Stable | Greater than zero. Defaults to 1. |
| `offering_packages[].lines[].rate_override` | decimal | | Stable | A rate for this package only. Workspace export includes it only for people with finance access, and import sets it only when the importer may edit finances. |
| `offering_packages[].lines[].note` | string | | Stable | Package line note. |


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