DDEX 4 Composites

PartyList and Party Composites

The <PartyList> and Party composites contain data about the parties (individuals, groups, companies, etc.) involved in a music release. This includes artists, labels, and other contributors.
The PartyList and Party composites are used by both Resource and Release composites.
See the elements below:
  • PartyList: A container for multiple Party composites.
  • Party: Contains details about a single party, including their name, ID, and role.
  • PartyReference IDs: Must start with the letter "P", used by other composites to link Party composites.
  • Party names: Name party, can be provided in different languages.
  • Party IDs: Can include proprietary IDs and ISNI (International Standard Name Identifier).

Sample XML:

<PartyList>

<Party>

<PartyReference>PJoeBozo</PartyReference>

<PartyName>

<FullName>Joe Bozo</FullName>

<FullNameIndexed>Bozo, Joe</FullNameIndexed>

</PartyName>

<PartyId>

<ProprietaryId Namespace="PADPIDA2013020802I">1234</ProprietaryId>

</PartyId>

<PartyId>

<ISNI>4567</ISNI>

</PartyId>

</Party>

</PartyList>

Don’t forget to:
  • Include a Party composite for each party involved in the release.
  • Assign a unique PartyReference ID to each party.
  • Provide party names to be used for display.
  • Include any relevant party IDs.

TrackRelease Composite

The <TrackRelease> composite is used to communicate metadata about individual tracks.
See the elements below:
  • ReleaseReference: A unique identifier for the track release, starting with the letter "R".
  • ReleaseId: Contains proprietary IDs for the track.
  • DisplayTitleText: The full title of the track, including any subtitles.
  • DisplayTitle: A compost that separates elements of the display title components (title, subtitle) and language variations.
  • ReleaseResourceReference: Links the TrackRelease to its corresponding Resource composite.
  • ReleaseLabelReference: Points to the label party in the PartyList composite.
  • Genre: Specifies the genre of the track.

Sample XML:

<TrackRelease>

<ReleaseReference>R1</ReleaseReference>

<ReleaseId>

<ProprietaryId Namespace="PADPIDA2013042401U">1234</ProprietaryId>

</ReleaseId>

<DisplayTitleText>Track 1 display title (subtitle)</DisplayTitleText>

<DisplayTitle ApplicableTerritoryCode="Worldwide" IsDefault="true">

<TitleText>Track 1 display title</TitleText>

<SubTitle>subtitle</SubTitle>

</DisplayTitle>

<ReleaseResourceReference>A1</ReleaseResourceReference>

<ReleaseLabelReference ApplicableTerritoryCode="Worldwide">PACMELabel</ReleaseLabelReference>

<Genre ApplicableTerritoryCode="Worldwide">

<GenreText>Pop</GenreText>

</Genre>

</TrackRelease>

Don’t forget to:
  • Create a TrackRelease composite for each track in the release.
  • Assign a unique ReleaseReference ID to each track release.
  • Link the TrackRelease to its corresponding Resource composite.
  • Specify the label and genre information.

SoundRecordingEdition Composite

The <SoundRecordingEdition> composite enables sending 1 or more resource files for a single resource e.g. different audio encoding, etc.
See the elements below:
  • ResourceId: Contains identifiers for the sound recording, such as ISRC.
  • PLine: Provides copyright information for the sound recording.
  • RecordingMode: Specifies the recording mode (e.g., Stereo, ImmersiveAudio, SurroundSound, etc).
  • TechnicalDetails: Contains technical details about the audio file, including codec, channels, sampling rate, and duration.
  • DeliveryFile: Contains details about the delivered audio file, including its format and location.
  • IsClip: Indicates whether the sound recording is a clip or a full track.

Sample XML:

<SoundRecordingEdition>

<ResourceId>

<ISRC>PLI360999999</ISRC>

</ResourceId>

<PLine IsDefault="true">

<Year>2008</Year>

<PLineCompany>Magic Records</PLineCompany>

<PLineText>℗ 2008 Magic Records</PLineText>

</PLine>

<RecordingMode>Stereo</RecordingMode>

<TechnicalDetails>

<TechnicalResourceDetailsReference>T6</TechnicalResourceDetailsReference>

<DeliveryFile>

<Type>AudioFile</Type>

<AudioCodecType>MP3</AudioCodecType>

<NumberOfChannels>2</NumberOfChannels>

<SamplingRate UnitOfMeasure="kHz">44.1</SamplingRate>

<BitsPerSample>16</BitsPerSample>

<Duration>PT0H3M15.013S</Duration>

<File>

<URI>t1.mp3</URI>

</File>

</DeliveryFile>

<IsClip>false</IsClip>

</TechnicalDetails>

</SoundRecordingEdition>

Don’t forget to:
  • Include a SoundRecordingEdition composite for each version of the sound recording.
  • Provide copyright information in the PLine.
  • Specify the recording mode.
  • Include detailed technical information about the audio file.
  • Use the DeliveryFile composite to provide file-specific details.

DeliveryFile Composite

The <DeliveryFile> composite provides detailed information about the audio file being delivered.
See the elements below:
  • Type: Specifies the type of file (e.g., AudioFile).
  • AudioCodecType: The codec used for the audio file (e.g., MP3, FLAC).
  • BitRate: The bitrate of the audio file.
  • NumberOfChannels: The number of audio channels.
  • SamplingRate: The sampling rate of the audio file.
  • BitsPerSample: The number of bits per sample.
  • Duration: The duration of the audio file.
  • File: Contains the URI (Uniform Resource Identifier) of the audio file.

Sample XML:

<DeliveryFile>

<Type>AudioFile</Type>

<AudioCodecType>MP3</AudioCodecType>

<BitRate UnitOfMeasure="kbps">128</BitRate>

<NumberOfChannels>2</NumberOfChannels>

<SamplingRate UnitOfMeasure="kHz">44.1</SamplingRate>

<BitsPerSample>16</BitsPerSample>

<Duration>PT0H0M30.000S</Duration>

<File>

<URI>resources/t6.mp3</URI>

</File>

</DeliveryFile>

Don’t forget to:
  • Include a DeliveryFile composite for each audio file delivered.
  • Specify the appropriate file type and codec.
  • Provide technical details about the audio file.
  • Include the URI / File path where the file can be retrieved.

ClipDetails Composite

The <ClipDetails> composite provides information about clips, which are short excerpts of a track.
See the elements below:
  • TechnicalResourceDetailsReference: A reference to the technical details of the clip.
  • ClipType: Specifies the type of clip (e.g., StandaloneClip, PreviewClip).
  • Timing: Contains information about the start point and duration of the clip.
  • ExpressionType: Indicates whether the clip is "Informative" or "Instructive".
  • DeliveryFile: Contains details about the delivered clip file (Similar to the DeliveryFile composite for full tracks).

Sample XML:

<ClipDetails>

<TechnicalResourceDetailsReference>T2C</TechnicalResourceDetailsReference>

<ClipType>StandaloneClip</ClipType>

<Timing>

<StartPoint>48</StartPoint>

<DurationUsed>PT0H1M00.000S</DurationUsed>

</Timing>

<ExpressionType>Informative</ExpressionType>

<DeliveryFile>

<Type>AudioFile</Type>

<AudioCodecType>MP3</AudioCodecType>

<BitRate UnitOfMeasure="kbps">128</BitRate>

<NumberOfChannels>2</NumberOfChannels>

<SamplingRate UnitOfMeasure="kHz">44.1</SamplingRate>

<BitsPerSample>16</BitsPerSample>

<Duration>PT0H1M00.000S</Duration>

<File>

<URI>resources/shortsSyncClip.mp3</URI>

</File>

</DeliveryFile>

</ClipDetails>

Don’t forget to:
  • Include a ClipDetails composite for each clip associated with a track.
  • Specify the appropriate clip type and timing information.
  • Provide technical details about the clip file using the DeliveryFile composite.
  • Set the ExpressionType to "Instructive" to inform the receiving party that a clip should be created from the host track using the start time and duration nodes.
  • Set the ExpressionType to "Informative" to inform the receiving party that the audio file is a clip created from the host track using the start time and duration nodes.

ClipRelease Composite

The <ClipRelease> composite is a new release type that enables content partners to provide clips that do not share metadata with the source track.
See the elements below:
  • ReleaseReference: A unique identifier for the clip release, starting with the letter "R".
  • ReleaseId: Contains proprietary IDs for the clip release.
  • DisplayTitleText: The full title of the clip release.
  • DisplayTitle: Allows for the breakdown of title components and language variations.
  • ReleaseResourceReference: Links the ClipRelease to its corresponding Resource composite.
  • ReleaseLabelReference: Points to the label party in the PartyList composite.
  • Genre: Specifies the genre of the clip release.

Sample XML:

<ClipRelease>

<ReleaseReference>R7</ReleaseReference>

<ReleaseId>

<ProprietaryId Namespace="PADPIDA2013042401U">1234</ProprietaryId>

</ReleaseId>

<DisplayTitleText>Clip 1 display title</DisplayTitleText>

<DisplayTitle ApplicableTerritoryCode="Worldwide" IsDefault="true">

<TitleText>Clip 1 from track 1 display title</TitleText>

</DisplayTitle>

<ReleaseResourceReference>A2</ReleaseResourceReference>

<ReleaseLabelReference>PACMELabel</ReleaseLabelReference>

<Genre>

<GenreText>Pop</GenreText>

</Genre>

</ClipRelease>

Don’t forget to:
  • Create a ClipRelease composite for each clip that has different metadata from the source track.
  • Assign a unique ReleaseReference ID to each clip release.
  • Provide accurate and complete title information.
  • Link the ClipRelease to its corresponding Resource composite.
  • Specify the label and genre information.
  • Include RelatedRelease composites in both the source track and the clip release to indicate their relationship.

Was this helpful?

How can we improve it?