General Metadata Mapping

Required Fields

The following metadata fields are required for content to be listed on Audius and are examined and pulled from a DDEX delivery in cascading precedence.

imageFile

• /ResourceList/Image/ImageDetailsByTerritory[TerritoryCode="Worldwide"]/TechnicalImageDetails/File/FilePath
• /ResourceList/Image/ImageDetailsByTerritory[TerritoryCode="Worldwide"]/TechnicalImageDetails/File/FileName

releaseDate

1. /ReleaseList/Release/ReleaseDetailsByTerritory[TerritoryCode="Worldwide"]/ReleaseDate
2. /ReleaseList/Release/GlobalOriginalReleaseDate
3. /DealList/ReleaseDeal/Deal/ValidityPeriod/StartDate

userId

1. checks each artist name (in order) against Audius database of OAuthed display names, and uses the first match

Optional Fields

The following fields are optional for content to be listed on Audius and are examined and pulled from a DDEX delivery in cascading precedence.

ddexReleaseIds

1. /ReleaseList/Release/ReleaseId

description

The DDEX standard includes a MarketingComments field that is rarely used, but is available.

Unused Fields

The following Audius SDK Fields are not used by DDEX and have no mapping.

child elements of /ReleaseList/Release/

The following child elements are parsed and stored in the separate DDEX server. Audius does not store these child fields and they are not used.

• ReferenceTitle/TitleText
• ReferenceTitle/SubTitle

child elements of /ReleaseList/Release/ReleaseDetailsByTerritory[TerritoryCode="Worldwide"]/

The following child elements are parsed and stored in the separate DDEX server. Audius does not store these child fields and they are not used.

• Title[@TitleType='DisplayTitle']/TitleText (used in albums/EPs but not single tracks)
• Title[@TitleType='DisplayTitle']/SubTitle
• Title[@TitleType='FormalTitle']/TitleText
• Title[@TitleType='FormalTitle']/SubTitle

child elements of /ReleaseList/Release/ReleaseDetailsByTerritory[TerritoryCode="Worldwide"]/ResourceGroup/

The following child elements are parsed and stored in the separate DDEX server. Audius does not store these child fields and they are not used.

• SequenceNumber
• ResourceGroupContentItem/ResourceType
• ResourceGroupContentItem/ReleaseResourceReference
• ResourceGroupContentItem/IsInstantGratificationResource

Track Metadata Mapping

Required Fields

The following fields are required for content to be listed on Audius and are examined and pulled from a DDEX delivery in cascading precedence.

genre

1. /ReleaseList/Release/ReleaseDetailsByTerritory[TerritoryCode="Worldwide"]/Genre/SubGenre
2. /ReleaseList/Release/ReleaseDetailsByTerritory[TerritoryCode="Worldwide"]/Genre/GenreText
3. /ResourceList/SoundRecording/SoundRecordingDetailsByTerritory[TerritoryCode="Worldwide"]/Genre/SubGenre
4. /ResourceList/SoundRecording/SoundRecordingDetailsByTerritory[TerritoryCode="Worldwide"]/Genre/GenreText

title

1. /ResourceList/SoundRecording/ReferenceTitle/TitleText

audioFile

This is the actual audio file, not technically an Audius SDK metadata field, but uploaded in the same SDK function. Note that this DDEX field is a relative path to the file within the delivery

• /ResourceList/SoundRecording/SoundDetailsByTerritory[TerritoryCode="Worldwide"]/TechnicalSoundRecordingDetails/File/FilePath
• /ResourceList/SoundRecording/SoundDetailsByTerritory[TerritoryCode="Worldwide"]/TechnicalSoundRecordingDetails/File/FileName

Optional Fields

The following fields are optional for content to be listed on Audius and are examined and pulled from a DDEX delivery in cascading precedence.

artists

The /PartyName/FullName child element is used as the artist’s name and the SequenceNumber attribute to preserve order

1. /ResourceList/SoundRecording/SoundRecordingDetailsByTerritory[TerritoryCode="Worldwide"]/DisplayArtist
2. /ReleaseList/Release/ReleaseDetailsByTerritory[TerritoryCode="Worldwide"]/DisplayArtist

copyrightLine

This is only used if both year AND text are non-empty. The child elements that are parsed are: Year and CLineText

1. /ResourceList/SoundRecording/SoundRecordingDetailsByTerritory[TerritoryCode="Worldwide"]/CLine
2. /ReleaseList/Release/ReleaseDetailsByTerritory[TerritoryCode="Worldwide"]/CLine
3. /ReleaseList/Release/CLine

indirectResourceContributors

1. /ResourceList/SoundRecording/SoundDetailsByTerritory[TerritoryCode="Worldwide"]/IndirectResourceContributor

isrc

1. /ResourceList/SoundRecording/SoundRecordingId/ISRC

iswc

1. /ReleaseList/Release/ReleaseId/ISWC

parentalWarningType

1. /ResourceList/SoundRecording/SoundRecordingDetailsByTerritory[TerritoryCode="Worldwide"]/ParentalWarningType
2. /ReleaseList/Release/ReleaseDetailsByTerritory[TerritoryCode="Worldwide"]/ParentalWarningType

previewStartSeconds

Preview length is 30 seconds starting at the previewStartSeconds into the track’s audio, even if a longer or shorter duration is given. does not support using an external file for the preview

1. /ResourceList/SoundRecording/SoundDetailsByTerritory[TerritoryCode="Worldwide"]/TechnicalSoundRecordingDetails/PreviewDetails/StartPoint
2. only when /ResourceList/SoundRecording/SoundDetailsByTerritory[TerritoryCode="Worldwide"]/TechnicalSoundRecordingDetails/IsPreview is true

producerCopyrightLine

1. /ResourceList/SoundRecording/SoundRecordingDetailsByTerritory[TerritoryCode="Worldwide"]/PLine
2. /ReleaseList/Release/ReleaseDetailsByTerritory[TerritoryCode="Worldwide"]/PLine
3. /ReleaseList/Release/PLine

resourceContributors

1. /ResourceList/SoundRecording/SoundDetailsByTerritory[TerritoryCode="Worldwide"]/ResourceContributor

rightsController

1. /ResourceList/SoundRecording/SoundDetailsByTerritory[TerritoryCode="Worldwide"]/RightsController

Album Metadata Mapping

Required Fields

The following fields are required for content to be listed on Audius and are examined and pulled from a DDEX delivery in cascading precedence.

albumName

1. /ReleaseList/Release/ReleaseDetailsByTerritory[TerritoryCode="Worldwide"]/Title[@TitleType='DisplayTitle']/TitleText

genre

1. /ReleaseList/Release/ReleaseDetailsByTerritory[TerritoryCode="Worldwide"]/Genre/SubGenre
2. /ReleaseList/Release/ReleaseDetailsByTerritory[TerritoryCode="Worldwide"]/Genre/GenreText

audioFiles

This is an array of audio files which the album is comprised of, not technically an Audius SDK metadata field, but uploaded as part of the album.

1. each /ReleaseList/Release/ except the release with the attribute IsMainRelease="true"

trackMetadatas

Metadata about each track in the album, not technically an Audius SDK metadata field, but uploaded as part of the album

1. each /ReleaseList/Release/ except the release with the attribute IsMainRelease="true"

Optional Fields

The following fields are optional for content to be listed on Audius and are examined and pulled from a DDEX delivery in cascading precedence.

artists

The /PartyName/FullName child element is used as the artist’s name and the SequenceNumber attribute to preserve order

1. /ReleaseList/Release/ReleaseDetailsByTerritory[TerritoryCode="Worldwide"]/DisplayArtist

copyrightLine

1. /ReleaseList/Release/ReleaseDetailsByTerritory[TerritoryCode="Worldwide"]/CLine
2. /ReleaseList/Release/CLine

parentalWarningType

1. /ReleaseList/Release/ReleaseDetailsByTerritory[TerritoryCode="Worldwide"]/ParentalWarningType

producerCopyrightLine

1. /ReleaseList/Release/ReleaseDetailsByTerritory[TerritoryCode="Worldwide"]/PLine
2. /ReleaseList/Release/PLine

upc

1. /ReleaseList/Release/ReleaseId/ICPN