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

# Songs and setlists import fields

> Import file fields (version 2.0) for songs and setlists, with an example for each.

These are the fields for songs and setlists. 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.

***

## Songs (`songs[]`)

The repertoire.

| Field | Type | Required | Status | Notes |
| - | - | - | - | - |
| `songs[].title` | string | Yes | Stable | Song title. Together with the artist this is the dedup key. |
| `songs[].artist` | string | | Stable | Recording artist. Two songs with the same title and different artists stay separate. |
| `songs[].duration` | integer 1–86400 | | Stable | Length of the song in whole seconds (251 for 4:11). A JSON document takes a number; mm:ss text is read only from a spreadsheet column. |
| `songs[].key` | string | | Stable | Key. |
| `songs[].tempo` | integer 1–999 | | Stable | Tempo (BPM). |
| `songs[].notes` | string | | Stable | Notes. |

### Example: songs

A song with its duration in seconds and tempo.

```json theme={null}
{
  "schema_version": "2.0",
  "source": {
    "type": "SPREADSHEET",
    "name": "repertoire.csv"
  },
  "songs": [
    {
      "title": "September",
      "artist": "Earth, Wind & Fire",
      "duration": 215,
      "key": "A",
      "tempo": 126
    }
  ]
}
```

***

## Setlists (`setlists[]`)

Setlists and their sets.

| Field | Type | Required | Status | Notes |
| - | - | - | - | - |
| `setlists[].title` | string | | Stable | Rows sharing a title become one setlist. Also the dedup key. |
| `setlists[].is_template` | boolean | | Stable | Mark the setlist reusable rather than tied to one gig. |
| `setlists[].sets[].name` | string | | Stable | Set name. |
| `setlists[].sets[].title` | string | | Stable | Alias for the set name. Import rejects a set whose title differs from its name. |
| `setlists[].sets[].order` | integer ≥ 0 | | Stable | Set order. |
| `setlists[].sets[].songs[].title` | string | | Stable | Song title. |
| `setlists[].sets[].songs[].artist` | string | | Stable | Song artist. |
| `setlists[].sets[].songs[].duration` | integer 1–86400 | | Stable | Length of the song in whole seconds (251 for 4:11). A JSON document takes a number; mm:ss text is read only from a spreadsheet column. |
| `setlists[].sets[].songs[].key` | string | | Stable | Song key. |
| `setlists[].sets[].songs[].tempo` | integer 1–999 | | Stable | Song tempo. |
| `setlists[].sets[].songs[].notes` | string | | Stable | Song notes. |

### Example: setlists

A setlist template with one set of two songs.

```json theme={null}
{
  "schema_version": "2.0",
  "source": {
    "type": "PASTE",
    "name": "wedding-sets"
  },
  "setlists": [
    {
      "title": "Wedding reception",
      "is_template": true,
      "sets": [
        {
          "name": "First dance set",
          "order": 1,
          "songs": [
            {
              "title": "At Last",
              "artist": "Etta James"
            },
            {
              "title": "September",
              "artist": "Earth, Wind & Fire",
              "duration": 215
            }
          ]
        }
      ]
    }
  ]
}
```


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