Back to Home
Technical Reference

Data
Dictionary

Exhaustive technical definitions for every metadata field required by major streaming platforms. Each entry includes the field type, format specification, an example value, and the stores that require it.

34 fields documented
7 categories

ISRC

IdentifiersAll stores

International Standard Recording Code. A 12-character alphanumeric identifier that uniquely identifies a specific sound recording. The first two characters are the country code, followed by 3-character registrant code, 2-digit year, and 5-digit designation code.

Typestring (12 chars)
FormatCC-XXX-YY-NNNNN
ExampleWLND24000012
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

UPC / EAN-13

IdentifiersAll stores

Universal Product Code / European Article Number. A 13-digit barcode identifying a release. The 13th digit is a check digit calculated from the preceding 12 digits using the GS1 modulo-10 algorithm.

Typestring (13 digits)
FormatNNNNNNNNNNNNC
Example19264100033
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

ISWC

IdentifiersApple Music, Tidal

International Standard Musical Work Code. Identifies a musical composition (as distinct from a recording). Required for songwriter royalty collection. Format: T followed by 9 digits and a check digit.

Typestring (11 chars)
FormatT-XXXXXXXXX-C
ExampleT-034524680-1
Stores:Apple MusicApple MusicTidalTidalDeezerDeezer

ISNI

IdentifiersRecommended

International Standard Name Identifier. A 16-digit identifier disambiguating contributors. Recommended for all artist and songwriter credits to prevent identity confusion when multiple artists share the same name.

Typestring (16 chars)
FormatNNNNNNNNNNNNNNNC
Example0000000121034086
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon Music

Catalog Number

IdentifiersOptional

A label-assigned catalog number for the release. Not required by stores but displayed on some artist pages and used for internal label tracking.

Typestring
FormatFree text
ExampleWLND-024
Stores:SpotifySpotifyApple MusicApple MusicDeezerDeezer

Release Title

Title & TextAll stores

The official title of the release. Must contain only the artistic name of the release — no SEO descriptors, marketing copy, or search-intent phrases. Standard title case capitalization for the release's language.

Typestring
FormatFree text (UTF-8)
ExampleMidnight Frequencies
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

Track Title

Title & TextAll stores

The official title of an individual track. Must match exactly across the audio file, artwork, and metadata. Parenthetical descriptors allowed only for legitimate version info: (Remix), (Acoustic), (Live), (Radio Edit).

Typestring
FormatFree text (UTF-8)
ExampleMidnight Frequencies
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

Subtitle

Title & TextOptional

An optional secondary title field. Used for subtitle or volume information (e.g., 'Vol. 2'). Not a place for marketing copy or mood descriptors.

Typestring
FormatFree text (UTF-8)
ExampleVol. 2
Stores:Apple MusicApple MusicDeezerDeezer

Version Title

Title & TextOptional

A separate field for version information. Some stores prefer version info here rather than in parentheses in the main title. Acceptable values: Remix, Acoustic, Live, Radio Edit, Extended Mix.

Typestring
FormatFree text (UTF-8)
ExampleRemix
Stores:SpotifySpotifyApple MusicApple MusicTidalTidal

Character Encoding

Title & TextAll stores

All text fields must be encoded in UTF-8. Non-UTF-8 encodings (Latin-1, Windows-1252) cause mojibake on international stores — diacritics and special characters display incorrectly.

Typeenum
FormatUTF-8
ExampleUTF-8
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

Cover Art

ArtworkAll stores

The primary cover artwork for the release. Must be a square image at minimum 3000×3000px (1400×1400px for Deezer). Color space must be RGB or sRGB — CMYK is rejected. No text overlay, watermarks, or promotional graphics.

Typefile (image)
FormatJPG / PNG
Examplecover_3000x3000.jpg
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

Artwork Resolution

ArtworkAll stores

Pixel dimensions of the cover art. 3000×3000px is the industry standard minimum for HiFi stores (Spotify, Apple Music, Tidal, YouTube Music). Deezer accepts 1400×1400px minimum. DPI is irrelevant — only pixel dimensions matter.

Typenumber (pixels)
Format3000×3000 minimum
Example3000
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

Artwork Color Space

ArtworkAll stores

The color profile of the cover art. RGB or sRGB is required. CMYK color space is rejected by all stores as it is designed for print, not digital display.

Typeenum
FormatRGB / sRGB
ExamplesRGB
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

Additional Images

ArtworkOptional

Optional supplementary images such as back cover, booklet, or liner notes. Not required by any store but displayed on some artist pages where supported.

Typefile (image)
FormatJPG / PNG
Examplebooklet.pdf
Stores:Apple MusicApple MusicAMAmazon Music

Primary Artist

ContributorsAll stores

The main performing artist name. Must be the official performing name exactly as registered with the label or PRO. Only the primary artist — featured artists go in the contributor field with a 'Featured Artist' role.

Typestring
FormatFree text (UTF-8)
ExampleNova Hartley
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

Contributor Name

ContributorsAll stores

Full name of a contributor to the recording. Songwriter and composer credits must use legal names (not stage names) for PRO royalty collection. Performer and Producer credits may use stage names.

Typestring
FormatFree text (UTF-8)
ExampleJames Cole
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

Contributor Role

ContributorsAll stores

The role assigned to a contributor. Must use standard DDEX role codes: Performer, Songwriter, Composer, Producer, Mixer, Mastering Engineer, Featured Artist. Custom role names are rejected.

Typeenum (DDEX)
FormatStandard role code
ExampleProducer
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

Featured Artist

ContributorsConditional

A guest artist featured on a track. Must be entered as a separate contributor with the 'Featured Artist' role — not appended to the primary artist name field (e.g., not 'Artist feat. Guest').

Typestring
FormatFree text (UTF-8)
ExampleMaya Lindqvist
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

Songwriter Split

ContributorsApple Music, Tidal

The percentage share of a songwriter's contribution to a composition. Used for royalty split calculations. All splits for a single composition must total 100%.

Typenumber (percentage)
Format0–100
Example50
Stores:Apple MusicApple MusicTidalTidalDeezerDeezer

Genre

Genre & LanguageAll stores

The primary genre classification. Must be mapped to each target store's proprietary taxonomy — there is no universal genre list. Using a distributor genre tag without mapping causes browse category misplacement.

Typeenum (per-store)
FormatStore taxonomy value
ExampleElectronic
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

Subgenre

Genre & LanguageConditional

A secondary genre classification. Only populated if the target store supports nested genre taxonomies (e.g., Amazon Music's 3-level hierarchy, Deezer's v3.2 taxonomy). Flat-taxonomy stores like Apple Music do not accept subgenres.

Typeenum (per-store)
FormatStore taxonomy value
ExampleDance
Stores:AMAmazon MusicDeezerDeezerSpotifySpotify

Language Code

Genre & LanguageAll stores

The ISO 639-1 two-letter language code identifying the language of the lyrics. Must match the actual vocal language for lyric synchronization. Instrumental tracks should use the instrumental flag instead.

Typeenum (ISO 639-1)
Format2-letter code
Exampleen
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

Explicit Content Flag

Genre & LanguageAll stores

Indicates whether the track contains explicit lyrics. Must be set accurately for every track. Stores display an 'E' label on explicit content and offer parental filtering based on this flag.

Typeboolean
Formattrue / false
Examplefalse
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

Instrumental Flag

Genre & LanguageConditional

Indicates whether the track is instrumental (no vocals). When set to true, the language code field may be omitted. Stores use this flag to categorize instrumental music in browse sections.

Typeboolean
Formattrue / false
Examplefalse
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicDeezerDeezer

Release Date

Release DetailsAll stores

The official release date. Must be in ISO 8601 format. Cannot be more than 6 months in the future for pre-release scheduling. Past dates are accepted for back-catalog delivery.

Typedate (ISO 8601)
FormatYYYY-MM-DD
Example2026-08-15
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

Pre-Order Date

Release DetailsOptional

The date the release becomes available for pre-order. Must be before the release date. Some stores display a pre-order badge and allow instant-gratification tracks.

Typedate (ISO 8601)
FormatYYYY-MM-DD
Example2026-07-15
Stores:Apple MusicApple MusicAMAmazon Music

Track Duration

Release DetailsAll stores

The duration of each track in seconds. Must match the actual audio file duration within a 2-second tolerance. Discrepancies cause playback issues on some stores.

Typenumber (seconds)
FormatInteger
Example214
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

Track Number

Release DetailsAll stores

The position of the track within the release. Must be sequential starting from 1. Gapless or non-sequential numbering is rejected by most stores.

Typenumber
FormatInteger (sequential)
Example1
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

Volume Number

Release DetailsConditional

The volume/disc number for multi-disc releases. Required only for releases spanning multiple volumes. Single-volume releases should default to 1.

Typenumber
FormatInteger
Example1
Stores:Apple MusicApple MusicAMAmazon MusicDeezerDeezer

Territory Rights

Release DetailsAll stores

The territories where the release is licensed for distribution. Specified as ISO 3166-1 alpha-2 country codes or the keyword 'Worldwide'. Must be set for each track and the overall release.

Typearray (ISO 3166-1)
FormatCountry codes or 'Worldwide'
ExampleWorldwide
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

P-Line

RightsApple Music, Tidal

The phonogram copyright notice identifying the owner of the sound recording rights. Format: year of first publication followed by the rights holder name.

Typestring
FormatYYYY Rights Holder
Example2026 Wavelength Records
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

C-Line

RightsApple Music, Tidal

The copyright notice identifying the owner of the composition rights. Format: year of first publication followed by the rights holder name. Distinct from the P-Line which covers the sound recording.

Typestring
FormatYYYY Rights Holder
Example2026 Nova Hartley
Stores:SpotifySpotifyApple MusicApple MusicAMAmazon MusicTidalTidalDeezerDeezerYouTube MusicYouTube Music

Master Rights Owner

RightsConditional

The owner of the master recording rights. Required by some stores for royalty allocation. Typically the record label or, for independent artists, the artist themselves.

Typestring
FormatFree text (UTF-8)
ExampleWavelength Records
Stores:Apple MusicApple MusicTidalTidalDeezerDeezer

Publishing Rights Owner

RightsConditional

The owner of the publishing (composition) rights. Required by some stores for mechanical royalty collection. Typically a publishing company or, for self-published artists, the songwriter.

Typestring
FormatFree text (UTF-8)
ExampleRootnote Publishing
Stores:Apple MusicApple MusicTidalTidalDeezerDeezer

Validate against the dictionary

Our engine checks every field on this page automatically — type, format, and store-specific requirements — in a single pass.