Version: June 2026

Cue Sheet Template JSON

This document describes the JSON format that stores cuesheet templates. It can be used for our "Music Cue Sheet (Converter)" and "Music Cue Sheet Manager".

Overview

The JSON is a single object with two top-level keys: header and data.

{
  "header": {
    "logo": 1,
    "columns": 2,
    "column": [ [ ... ], [ ... ], [ ... ] ]
  },
  "data": {
    "columns": [ ... ]
  }
}

Top Level

Key	Type	Description
`header`	Object	Everything shown in the cue sheet header block.
`data`	Object	The repeating data table (one row per music cue).

Header

Key	Type	Description
`logo`	Integer (0 / 1)	Whether the logo is shown in the header. `1` = show, `0` = hidden. Defaults to `1` when missing. The logo can be set by the user in the account settings. If no user logo exists a editingtools placeholder logo will be used.
`columns`	Integer / String	Number of header columns to render (the "header type"). Read as an integer; defaults to `2` when missing. A value of `0` means the header is hidden. Value can be 0,1,2 or 3.
`column`	Array	Fixed-length array of up to 3 entries, one per header column. Each entry is an array of field objects (may be empty).

Each element of header.column[n] is a field object:

{
  "id": "title",
  "displayName": "Track Title",
  "width": "",
  "value": ""
}

Key	Type	Description
`id`	String	Field identifier (e.g. `production_title`, `network`, `year_of_production`). Must be a valid `header` key (see Field Reference).
`displayName`	String	Enter a custom label to display. If left empty, the default header name for the field will be used. This can be used to provide a translated header since headers are displayed in English by default.
`width`	String	The column width can be used to change the default width, if desired. Recommended values in between 20 and 40.
`value`	String	Optional. Enter the value for the field. An empty string means that no value is set or it uses the one stored within a project.

Example

"header": {
  "logo": 1,
  "columns": 2,
  "column": [
    [
      { "id": "production_type", "displayName": "", "width": "", "value": "Series" },
      { "id": "production_title", "displayName": "", "width": "", "value": "The Simpsons" },
      { "id": "first_release_date", "displayName": "", "width": "", "value": "28.9.2025" }
    ],
    [
      { "id": "season_number", "displayName": "", "width": "", "value": "37" },
      { "id": "episode_number", "displayName": "", "width": "", "value": "1" },
      { "id": "network", "displayName": "", "width": "", "value": "Fox" }
    ]
  ]
}

Data

Key	Type	Description
`columns`	Array	Ordered list of field objects, one per column in the data table. Array order is the left-to-right column order in the rendered table.

Each element of data.columns is a field object with the same shape as the header field object:

{
  "id": "track_title",
  "displayName": "Title",
  "width": ""
}

Key	Type	Description
`id`	String	Data field identifier (e.g. `track_title`, `tc_in1`, `duration2`, `isrc`). Must be a valid `musiccuesheet` key (see Field Reference).
`displayName`	String	Optional custom column header text. Empty string means "use the field's value".
`width`	String	Optional change of width of a column. Recommended values. Use values in between 10 and 50. The default uses 12 for timecodes, and 30 or 40 for values like Track Name.

Example

"data": {
  "columns": [
    { "id": "number",      "displayName": "#",        "width": "10" },
    { "id": "tc_in1",      "displayName": "",		"width": "" },
    { "id": "tc_out1",     "displayName": "",		"width": "" },
    { "id": "track_title", "displayName": "Title",    "width": "30" },
    { "id": "composer",    "displayName": "Composer", "width": "" },
    { "id": "isrc",        "displayName": "ISRC",     "width": "" }
  ]
}

Complete Example

{
  "header": {
    "logo": 1,
    "columns": 2,
    "column": [
	    [
	      { "id": "production_type", "displayName": "", "width": "", "value": "Series" },
	      { "id": "production_title", "displayName": "", "width": "", "value": "The Simpsons" },
	      { "id": "first_release_date", "displayName": "", "width": "", "value": "28.9.2025" }
	    ],
	    [
	      { "id": "season_number", "displayName": "", "width": "", "value": "37" },
	      { "id": "episode_number", "displayName": "", "width": "", "value": "1" },
	      { "id": "network", "displayName": "", "width": "", "value": "Fox" }
	    ]
    ]
  },
  "data": {
    "columns": [
      { "id": "number",      "displayName": "#",        "width": "10" },
      { "id": "tc_in1",      "displayName": "",		"width": "" },
      { "id": "tc_out1",     "displayName": "",		"width": "" },
      { "id": "duration1",   "displayName": "Duration", "width": "" },
      { "id": "track_title", "displayName": "Title",    "width": "30" },
      { "id": "composer",    "displayName": "Composer", "width": "" },
      { "id": "artist",      "displayName": "Artist",   "width": "" },
      { "id": "isrc",        "displayName": "ISRC",     "width": "" }
    ]
  }
}

Field Reference: Data Fields

Allowed id values for objects in data.columns, grouped as in the field picker. The id is what goes into the JSON; the label is the default display text used when displayName is empty.

Number

ID	Description	Example value
`placeholder`	- Empty Placeholder Column -
`number`	Cue No.	1

Timecode In

ID	Description	Example value
`tc_in1`	Timecode In (SMPTE)	00:00:00:00
`tc_in2`	Timecode In (HH:MM:SS)	00:00:00
`tc_in3`	Timecode In (HH:MM:SS,MS)	00:00:00,000
`tc_in4`	Timecode In (M:SS)	0:00
`tc_in5`	Timecode In (in Seconds)	0
`tc_in6`	Timecode In (in Frames)	0
`tc_in7`	Timecode In (only HH)	00
`tc_in8`	Timecode In (only MM)	00
`tc_in9`	Timecode In (only SS)	00

Timecode Out

ID	Description	Example value
`tc_out1`	Timecode Out (SMPTE)	00:02:30:00
`tc_out2`	Timecode Out (HH:MM:SS)	00:02:30
`tc_out3`	Timecode Out (HH:MM:SS,MS)	00:02:30,000
`tc_out4`	Timecode Out (M:SS)	2:30
`tc_out5`	Timecode Out (in Seconds)	150
`tc_out6`	Timecode Out (in Frames)	3750
`tc_out7`	Timecode Out (only HH)	00
`tc_out8`	Timecode Out (only MM)	02
`tc_out9`	Timecode Out (only SS)	30

Duration

ID	Description	Example value
`duration5`	Duration (SMPTE)	00:02:30:00
`duration1`	Duration (HH:MM:SS)	00:02:30
`duration2`	Duration (M:SS)	2:30
`duration3`	Duration (in Seconds, rounded)	150
`duration4`	Duration (in Frames)	3750
`duration6`	Duration (only MM)	02
`duration7`	Duration (only SS)	30

File

ID	Description	Example value
`track_title`	Title	Rising Shadows
`filename`	Filename	EPIC042_01_Rising-Shadows
`file`	File (with Extension)	EPIC042_01_Rising-Shadows.wav
`filepath`	Filepath	/audio/EPIC042_01_Rising-Shadows.wav

Library

ID	Description	Example value
`title`	Song Title	Rising Shadows
`composer`	Composer	John Doe
`composer_number`	Composer CAE/IPI Number	001234567
`composer_society`	Composer Society	GEMA
`composer_shares`	Composer Shares (%)	50
`composer_role`	Composer Role	Writer
`artist`	Artist \| Interpret	John Doe
`owner`	Owner	Global Music Publishing GmbH
`publisher_name`	Publisher	Global Music Publishing GmbH
`publisher_number`	Publisher CAE/IPI Number	000987654
`publisher_society`	Publisher Society	GEMA
`publisher_shares`	Publisher Shares (%)	100
`publisher_role`	Publisher Role	Publisher
`publisher_territory`	Publisher Territory	Worldwide
`label_name`	Label	Premium Score Library
`label_code`	Labelcode	12345
`album_title`	Album Title	Epic Modern Hybrid Trailers
`album_release_date`	Album Release Date	2026-05-25
`album_catalog_code`	Album Catalog Code	EPIC042
`album_catalog_number`	Album Catalog No.	10402
`catalog_name`	Catalog/Library Name	Action & Drama Beats
`track_number`	Track No.	1
`track_code`	Track Code	EPIC042_01
`track_duration`	Track Duration	150
`track_id`	Track ID	98765
`cd_no`	CD No.
`cd_code`	CD Code
`ean`	EAN	0123456789012
`upc`	UPC	123456789012
`isrc`	ISRC	USABC1234567
`iswc`	ISWC	T1234567890
`gema`	GEMA	99887766-001
`bpm`	BPM	120
`genre`	Genre	Cinematic Orchestral
`comment`	Comment

Custom Field

ID	Description	Example value
`note`	Note
`date1`	Date (YYYY-MM-DD)	2026-05-25
`date2`	Date (DD.MM.YYYY)	25.05.2026
`date3`	Date (MM/DD/YYYY)	05/25/2026
`date4`	Date (DD/MM/YYYY)	25/05/2026
`date5`	Date (DD. Month YYYY)	25. May 2026
`date6`	Date (Month DD, YYYY)	May 25, 2026

Sequence

ID	Description	Example value
`framerate`	Sequence Framerate	25
`track`	Audio Track No. in Sequence	1
`uses`	Number of uses	1

Clip

ID	Description	Example value
`reel`	Source Reel Name	A001
`source_framerate`	Source Clip Framerate	25
`clip_status`	Clip Status (Enabled/Disabled)	Enabled

Source In

ID	Description	Example value
`source_in1`	Source In (SMPTE)	01:00:00:00
`source_in2`	Source In (HH:MM:SS)	01:00:00
`source_in3`	Source In (HH:MM:SS,MS)	01:00:00,000
`source_in4`	Source In (M:SS)	0:00
`source_in5`	Source In (in Seconds)	3600
`source_in6`	Source In (in Frames)	90000

Source Out

ID	Description	Example value
`source_out1`	Source Out (SMPTE)	01:02:30:00
`source_out2`	Source Out (HH:MM:SS)	01:02:30
`source_out3`	Source Out (HH:MM:SS,MS)	01:02:30,000
`source_out4`	Source Out (M:SS)	2:30
`source_out5`	Source Out (in Seconds)	3750
`source_out6`	Source Out (in Frames)	93750

Field Reference: Header Fields

Allowed id values for the field objects inside header.column[0], header.column[1], and header.column[2].

Placeholder

ID	Description
`placeholder`	- Empty Placeholder Column -

Production

ID	Description
`production_type`	Production Type
`production_category`	Production Title
`production_title`	Production Title
`alternative_production_title`	Alternative Production Title
`cue_sheet_classification`	Cue Sheet Classification
`submit_date`	Submit Date/Revision Date
`first_release_date`	First Release Date
`version`	Version
`version_category`	Version Category
`version_comment`	Version Comment
`version_territory`	Version Territory
`territory_of_first_broadcast`	Territory of First Broadcast
`language`	Language
`network`	Network
`year_of_production`	Year of Production
`production_duration`	Production Duration
`total_music_duration`	Total Music Duration
`season_number`	Season Number
`episode_title`	Episode Title
`alternative_episode_title`	Alternative Episode Title
`episode_number`	Episode Number
`country_of_production_1`	Country of Production 1
`country_of_production_2`	Country of Production 2
`country_of_production_3`	Country of Production 3
`av_identifier`	AV Identifier
`av_identifier_source`	AV Identifier Source
`production_identifier_source`	Production Identifier Source
`production_identifier`	Production Identifier

Provider

ID	Description
`cue_sheet_provider`	Cue Sheet Provider
`cue_sheet_prepared_by`	Cue Sheet Prepared By
`role_of_cue_sheet_provider`	Role of Cue Sheet Provider
`provider_email`	Cue Sheet Provider Email
`provider_reference_no`	Cue Sheet Provider Reference No

Interested Parties

ID	Description
`av_interested_party_role_1`	AV Interested Party Role
`name_of_av_interested_party_1`	Name of AV Interested Party
`av_interested_party_role_2`	AV Interested Party Role 2
`name_of_av_interested_party_2`	Name of AV Interested Party 2
`av_interested_party_role_3`	AV Interested Party Role 3
`name_of_av_interested_party_3`	Name of AV Interested Party 3

Example with all fields

{
  "name": "Full Field Template",
  "header": {
    "logo": 1,
    "columns": 3,
    "column": [
      [
        { "id": "production_type", "displayName": "", "width": "", "value": "" },
        { "id": "alternative_production_title", "displayName": "", "width": "", "value": "" },
        { "id": "first_release_date", "displayName": "", "width": "", "value": "" },
        { "id": "version_comment", "displayName": "", "width": "", "value": "" },
        { "id": "language", "displayName": "", "width": "", "value": "" },
        { "id": "production_duration", "displayName": "", "width": "", "value": "" },
        { "id": "episode_title", "displayName": "", "width": "", "value": "" },
        { "id": "country_of_production_1", "displayName": "", "width": "", "value": "" },
        { "id": "av_identifier", "displayName": "", "width": "", "value": "" },
        { "id": "production_identifier", "displayName": "", "width": "", "value": "" },
        { "id": "role_of_cue_sheet_provider", "displayName": "", "width": "", "value": "" },
        { "id": "av_interested_party_role_1", "displayName": "", "width": "", "value": "" },
        { "id": "name_of_av_interested_party_2", "displayName": "", "width": "", "value": "" }
      ],
      [
        { "id": "production_category", "displayName": "", "width": "", "value": "" },
        { "id": "cue_sheet_classification", "displayName": "", "width": "", "value": "" },
        { "id": "version", "displayName": "", "width": "", "value": "" },
        { "id": "version_territory", "displayName": "", "width": "", "value": "" },
        { "id": "network", "displayName": "", "width": "", "value": "" },
        { "id": "total_music_duration", "displayName": "", "width": "", "value": "" },
        { "id": "alternative_episode_title", "displayName": "", "width": "", "value": "" },
        { "id": "country_of_production_2", "displayName": "", "width": "", "value": "" },
        { "id": "av_identifier_source", "displayName": "", "width": "", "value": "" },
        { "id": "cue_sheet_provider", "displayName": "", "width": "", "value": "" },
        { "id": "provider_email", "displayName": "", "width": "", "value": "" },
        { "id": "name_of_av_interested_party_1", "displayName": "", "width": "", "value": "" },
        { "id": "av_interested_party_role_3", "displayName": "", "width": "", "value": "" }
      ],
      [
        { "id": "production_title", "displayName": "", "width": "", "value": "" },
        { "id": "submit_date", "displayName": "", "width": "", "value": "" },
        { "id": "version_category", "displayName": "", "width": "", "value": "" },
        { "id": "territory_of_first_broadcast", "displayName": "", "width": "", "value": "" },
        { "id": "year_of_production", "displayName": "", "width": "", "value": "" },
        { "id": "season_number", "displayName": "", "width": "", "value": "" },
        { "id": "episode_number", "displayName": "", "width": "", "value": "" },
        { "id": "country_of_production_3", "displayName": "", "width": "", "value": "" },
        { "id": "production_identifier_source", "displayName": "", "width": "", "value": "" },
        { "id": "cue_sheet_prepared_by", "displayName": "", "width": "", "value": "" },
        { "id": "provider_reference_no", "displayName": "", "width": "", "value": "" },
        { "id": "av_interested_party_role_2", "displayName": "", "width": "", "value": "" },
        { "id": "name_of_av_interested_party_3", "displayName": "", "width": "", "value": "" }
      ]
    ]
  },
  "data": {
    "columns": [
      { "id": "number", "displayName": "", "width": "" },
      { "id": "tc_in1", "displayName": "", "width": "" },
      { "id": "tc_in2", "displayName": "", "width": "" },
      { "id": "tc_in3", "displayName": "", "width": "" },
      { "id": "tc_in4", "displayName": "", "width": "" },
      { "id": "tc_in5", "displayName": "", "width": "" },
      { "id": "tc_in6", "displayName": "", "width": "" },
      { "id": "tc_in7", "displayName": "", "width": "" },
      { "id": "tc_in8", "displayName": "", "width": "" },
      { "id": "tc_in9", "displayName": "", "width": "" },
      { "id": "tc_out1", "displayName": "", "width": "" },
      { "id": "tc_out2", "displayName": "", "width": "" },
      { "id": "tc_out3", "displayName": "", "width": "" },
      { "id": "tc_out4", "displayName": "", "width": "" },
      { "id": "tc_out5", "displayName": "", "width": "" },
      { "id": "tc_out6", "displayName": "", "width": "" },
      { "id": "tc_out7", "displayName": "", "width": "" },
      { "id": "tc_out8", "displayName": "", "width": "" },
      { "id": "tc_out9", "displayName": "", "width": "" },
      { "id": "duration5", "displayName": "", "width": "" },
      { "id": "duration1", "displayName": "", "width": "" },
      { "id": "duration2", "displayName": "", "width": "" },
      { "id": "duration3", "displayName": "", "width": "" },
      { "id": "duration4", "displayName": "", "width": "" },
      { "id": "duration6", "displayName": "", "width": "" },
      { "id": "duration7", "displayName": "", "width": "" },
      { "id": "track_title", "displayName": "", "width": "" },
      { "id": "filename", "displayName": "", "width": "" },
      { "id": "file", "displayName": "", "width": "" },
      { "id": "filepath", "displayName": "", "width": "" },
      { "id": "title", "displayName": "", "width": "" },
      { "id": "composer", "displayName": "", "width": "" },
      { "id": "composer_number", "displayName": "", "width": "" },
      { "id": "composer_society", "displayName": "", "width": "" },
      { "id": "composer_shares", "displayName": "", "width": "" },
      { "id": "composer_role", "displayName": "", "width": "" },
      { "id": "artist", "displayName": "", "width": "" },
      { "id": "owner", "displayName": "", "width": "" },
      { "id": "publisher_name", "displayName": "", "width": "" },
      { "id": "publisher_number", "displayName": "", "width": "" },
      { "id": "publisher_society", "displayName": "", "width": "" },
      { "id": "publisher_shares", "displayName": "", "width": "" },
      { "id": "publisher_role", "displayName": "", "width": "" },
      { "id": "publisher_territory", "displayName": "", "width": "" },
      { "id": "label_name", "displayName": "", "width": "" },
      { "id": "label_code", "displayName": "", "width": "" },
      { "id": "album_title", "displayName": "", "width": "" },
      { "id": "album_release_date", "displayName": "", "width": "" },
      { "id": "album_catalog_code", "displayName": "", "width": "" },
      { "id": "album_catalog_number", "displayName": "", "width": "" },
      { "id": "catalog_name", "displayName": "", "width": "" },
      { "id": "track_number", "displayName": "", "width": "" },
      { "id": "track_code", "displayName": "", "width": "" },
      { "id": "track_duration", "displayName": "", "width": "" },
      { "id": "track_id", "displayName": "", "width": "" },
      { "id": "cd_no", "displayName": "", "width": "" },
      { "id": "cd_code", "displayName": "", "width": "" },
      { "id": "ean", "displayName": "", "width": "" },
      { "id": "upc", "displayName": "", "width": "" },
      { "id": "isrc", "displayName": "", "width": "" },
      { "id": "iswc", "displayName": "", "width": "" },
      { "id": "gema", "displayName": "", "width": "" },
      { "id": "bpm", "displayName": "", "width": "" },
      { "id": "genre", "displayName": "", "width": "" },
      { "id": "comment", "displayName": "", "width": "" },
      { "id": "note", "displayName": "", "width": "" },
      { "id": "date1", "displayName": "", "width": "" },
      { "id": "date2", "displayName": "", "width": "" },
      { "id": "date3", "displayName": "", "width": "" },
      { "id": "date4", "displayName": "", "width": "" },
      { "id": "date5", "displayName": "", "width": "" },
      { "id": "date6", "displayName": "", "width": "" },
      { "id": "framerate", "displayName": "", "width": "" },
      { "id": "track", "displayName": "", "width": "" },
      { "id": "uses", "displayName": "", "width": "" },
      { "id": "reel", "displayName": "", "width": "" },
      { "id": "source_framerate", "displayName": "", "width": "" },
      { "id": "clip_status", "displayName": "", "width": "" },
      { "id": "source_in1", "displayName": "", "width": "" },
      { "id": "source_in2", "displayName": "", "width": "" },
      { "id": "source_in3", "displayName": "", "width": "" },
      { "id": "source_in4", "displayName": "", "width": "" },
      { "id": "source_in5", "displayName": "", "width": "" },
      { "id": "source_in6", "displayName": "", "width": "" },
      { "id": "source_out1", "displayName": "", "width": "" },
      { "id": "source_out2", "displayName": "", "width": "" },
      { "id": "source_out3", "displayName": "", "width": "" },
      { "id": "source_out4", "displayName": "", "width": "" },
      { "id": "source_out5", "displayName": "", "width": "" },
      { "id": "source_out6", "displayName": "", "width": "" }
    ]
  }
}