Search
Clear search
Close search
Google apps
Main menu

Expected metadata fields by asset type

The YouTube XML format is being replaced by DDEX (music only) and CSV templates (all industries). YouTube strongly discourages any new implementations of the YouTube XML format. This page should be used solely as reference material for existing implementations. Visit Using the YouTube DDEX feed for more information about the new format.
The features described in this article are available only to partners who use YouTube's Content Manager to manage their copyrighted content.

The following lists identify expected metadata fields for each asset type that YouTube supports. Note that YouTube will still process your feed even if you include a supported, but unexpected, metadata tag for a particular asset type but will flag the value in the response feed. For example, YouTube will process a feed that tries to associate a TMS ID with a sound recording but will not actually create the association.

Music-oriented assets (composition, sound recording, music_video)
composition:
<iswc>
<title>
<writer>
music_video:
<artist>
<genre>
<grid>
<isrc>
<label>
<title>
sound_recording:
<album>
<artist>
– required for any sound recording you are including in AudioSwap.
<genre> – required for any sound recording you are including in AudioSwap. You must specify a valid music genre.
<grid>
<isrc>
<label>
<title>
– required for any sound recording you are including in AudioSwap.
TV show and movie assets (episode, movie, season, show, trailer)

There are special metadata requirements for videos that appear in the Shows or Movies categories on YouTube.com. When you upload your feed, YouTube's feed handler enforces the rules listed below for any asset that has its <shows_and_movies_programming> element set to True. Assets that do not meet the requirements will not be processed. (Videos for episode or movie assets that do not have the <shows_and_movies_programming> element set to True can instead be categorized in one of the categories for web videos.)

For episode, movie, or trailer assets, you must create a video and claim the video as a match of the asset. An asset that appears in the Shows or Movies section must be linked to exactly one video. You can specify values for certain metadata fields as part of the asset definition or the video definition. For example, you can identify the <director> as a subtag of the <asset> tag or the <video> tag. When YouTube processes your upload, these shared metadata tags are ultimately stored as part of the video regardless of where you specified them in the feed. If you subsequently update the values for these fields, you must update them on the video. See Update video metadata for more information.

If your feed contains information for a new trailer asset, the feed must also contain a relationship that identifies the movie that the trailer promotes.

episode:
<actor>
<content_type>
<custom_id>
– Required. Valid values are Full Episode and Clip.
<description> – Required.
<director>
<episode>
– Required.
<notes>
<original_release_date>
– Required.
<original_release_medium> – Required.
<producer>
<rating>
– You do not need to specify a rating if the <content_type> is Clip.
<season>
– This value associates the episode with the proper season.
<show_custom_id> – This value associates the episode with the proper show.
<shows_and_movies_programming> – The tag value must be True.
<spoken_language>
<subtitled_language>
<title>
– Required.
<tms_id>
<URL>
<writer>
movie:
<actor>
<content_type>
Valid values are Feature Film and Short.
<custom_id>
<description>
– Required.
<director>
<genre>
– You must specify a valid movie genre.
<original_release_date> – Required.
<original_release_medium> – Required.
<producer>
<rating>
Required.
<shows_and_movies_programming> – The tag value must be True.
<spoken_language> – Required.
<subtitled_language>
<title>
– Required.
<tms_id>
<URL>
<writer>
season:
<season_name>
<custom_id>
<description>
<notes>
<original_release_date>
<season>
– Required.
<show_custom_id> – This value associates the season with the proper show.
<shows_and_movies_programming> – This element's value must be True for season assets
<total_episodes_expected>
<URL>
show:
<actor>
<broadcaster>
<custom_id>
– Required.
<description> – Required.
<director>
<genre>
– You must specify a valid television show genre.
keyword – Required.
<notes>
<producer>
<shows_and_movies_programming>
– This element's value must be True for show assets
spoken_language – Required.
<start_year> – Required.
<title> – Required.
<URL>
<writer>
trailer:
<actor>
<custom_id>
<description>
– Required.
<director>
<genre>
– You must specify a valid movie genre.
<original_release_date> – Required.
<original_release_medium> – Required.
<producer>
<rating>
– Required.
<shows_and_movies_programming> – Yhis element's value must be True.
<title> – Required.
<tms_id>
<URL>
<writer>
Web video assets (web)
Was this article helpful?
How can we improve it?
Resources for Creators

Check out the creator resources available to help you build your channel and connect with the community.