New required metadata fields.

July 2, 2020

In order to make your content visible in a set of European countries, you will need to provide the country of origin, production country, and the original spoken locale for your iTunes and Apple TV Channels video content by September 1, 2020.

In order to make your content visible in Colombia, you will need to provide the country of origin for your iTunes and Apple TV Channels video content by September 1, 2020.

For more details, review the FAQ below. 

Which services are affected?
iTunes Movies, iTunes TV, and Apple TV Channels. Bonus episodes, concert films, and sporting events are included.

Which services are not affected?
Streaming apps integrated into the Apple TV app.

Which countries are affected?
Austria (AT), Belgium (BE), Bulgaria (BG), Colombia (CO), Croatia (HR), Cyprus (CY), Czech Republic (CZ), Denmark (DK), Estonia (EE), Finland (FI), France (FR), Germany (DE), Greece (GR), Hungary (HU), Iceland (IS), Ireland (IE), Italy (IT), Latvia (LV), Liechtenstein (LI), Lithuania (LT), Luxembourg (LU), Malta (MT), Netherlands (NL), Norway (NO), Poland (PL), Portugal (PT), Romania (RO), Slovakia (SK), Slovenia (SI), Spain (ES), Sweden (SE), and United Kingdom (GB).

What fields are required and when will they go into effect for each service?
For European countries, country of origin, production country, and original spoken locale are all required for TV episodes, TV seasons, and movies. For Colombia, country of origin is required for TV episodes, TV seasons, and movies.

For iTunes, refer to the iTunes Package Film Specification and iTunes Package TV Specification for details. The fields are available to iTunes partners as of July 1, 2020. 

For Apple TV Channels, the fields will be defined in the 3.6.1 UMC Catalog Data Interface Specification and will be published on July 22, 2020. Until then, contact your Technical Partner Rep for details.

When will the new fields be enforced for the listed countries?
Fields will be enforced on a system level on September 1, 2020.

Does this affect new content only or my entire catalog?
It affects all content made available in the countries listed above.

How can I deliver or update the fields?
The fields can be delivered through iTunes Connect and Transporter for iTunes, or through the UMC catalog feed for Apple TV Channels. Note that original spoken locale for iTunes episodes and movies can only be updated through Transporter.  

What is the definition of country of origin?
Country of origin refers to where the content is primarily produced, where the main authors and workers reside, or where the main producer is established. Such determination must be made in accordance with applicable law. You must specify at least one country of origin and that country should be the primary country of origin. You can supply additional countries as needed. This may differ from the production country, which is the country that provided most of the funds for production. Both the country of origin and production country are required.

What is the definition of production country?
This is the ISO 3166-1 alpha-2 code of the country that is the primary source of funds for the film or TV content production. You must specify at least one production country and that country should be the country that provided most of the funds (for example, from national lotteries and other subsidies). You can supply additional countries as needed.

This is not the same as the country of origin, which is the country where the content originates from in accordance with applicable law. Both the country of origin and production country are required.

What is the definition of original spoken locale?
This specifies the language spoken by the actors in the film, episode, or season. The value used for locale is not case-sensitive. For example, if the language is English as spoken in the United Kingdom, en-GB must be specified as the original spoken locale. For Apple TV Channels, additional languages can be supplied as needed.

As a best practice when specifying a language, use the region subtag (for example, the GB of en-GB) only when it conveys helpful information, such as spelling variations between countries. In cases where specifying a region is appropriate, use a hyphen to combine a language subtag with a region subtag. This identifies both the language and the specific location where the language is used.

Back to What's New

Partner Search

Search for a partner who can help you get your TV shows on the iTunes Store.

Find a Partner

Customer Support

We're here to help you with questions about delivering and managing your TV.

More Help

Contact Us

Can’t find the answer to your question? Our support teams are ready to help.

Get in Touch