Catalog Import Requirements

Technical specifications for large catalogs to upload titles into the Filmhub ecosystem

In this guide:

• Asset Requirements
• Metadata & Avails
  
  • Metadata Glossary

---

Asset Requirements

Provide assets using these specs. More detailed technical information can be found on the Filmhub Asset Requirements page.

The table below shows which types of assets are supported for each format (movie, show, or episode). Some things to keep in mind:

• A main video and caption file is required for all movies and episodes. Title artwork is required for all movies and shows.
• Trailers and textless art are not required but highly recommended.
• Shows only support one trailer and one set of title artwork.
  • All episodes and seasons of a show share the same trailer and title art.
  • Episodes support a video and a caption file, plus a textless 16x9 thumbnail or still.

Find out more about preparing and delivering assets in bulk in Catalog Import: Asset Transfers.

Metadata & Avails

We need clear and accurate metadata for each title in a table so we can automatically fill in title descriptions, cast and crew, tags, avails, and other metadata in bulk. The columns in the table will map to each title's Profile and Listing pages: Profile metadata and Listing metadata.

Enter all movie and show on the Titles table. Episodes inherit most of their metadata from their parent show listing. An episode may have a unique name, description, and release date, which can be entered on the Episodes table. All other data is defined in the show. 

Avails can be defined by blocked channel, territory, date, and licensing type. Avails apply across all episodes and seasons of a show. Contact your acquisitions executive for titles with more complex avails.

Metadata Glossary

*Mandatory fields are marked with an asterisk

Metadata column	Description
Format*	Movie, Show, or Episode
Title Name*	Name of the Movie or Show.
Season Name	Name of the Season, may contain custom numbering.
Episode Name	Name of the Episode, may contain custom numbering.
ID	Optional internal identifier for tracking
Short Description*	Title synopsis under 255 characters including spaces.
Release Date*	Date of premiere, first airing, or wide release. YYYY-MM-DD
Countries of Production*	Country codes for the countries where the title was produced.
Genres*	Semicolon separated list of genres as defined in the Reference Lists.
Keywords	Semicolon separated list of keywords as defined in the Reference Lists. Keywords are also listed by category on the Keywords tab.
Sales Pitch	Unique title information under 300 characters.
Tags*	Semicolon separated list of at least 5 unique single-word tags that are not included with other metadata like Keywords or Genre.
Advisories*	Semicolon separated list of the Advisories Reference List, or None if none apply: harsh language, drugs, sex, nudity, violence, or flashing lights
Ratings*	Official rating as defined in the Reference Lists.
Cast*	Actors must be listed with their Role, separated by a slash. Multiple actors are separated by semicolons: Actor 1 Name / Actor 1 Role; Actor 2 Name / Actor 2 Role; ... If the actor is portraying themself, the Role should be Self. If no actors are in the title, the Director's name can be used.
Director*	At least 1 person's name. Groups or companies are not valid directors.
Writer	At least 1 person's name. Groups or companies are not valid writers.
Producer	At least 1 person's name. Groups or companies are not valid producers.
Production Company*	Group or company that produced the title.
Copyright Line*	The year followed by the copyright holder 2024 Paramount Pictures
IMDb*	Link to the title on IMDb
Public Domain	Mark TRUE if the title is in the public domain. Leave blank if not.
Notes	Any extra information that will be passed along to internal teams, not for public viewing.
Main Video*	Filename of the main feature video.
Primary Audio Language*	Language code that's spoken primarily throughout. Only 1 language is supported per title.
English Captions*	Filename of the English captions file.
Trailer	Filename of the trailer video.
Artwork 2x3*	Filename of the 2x3 artwork
Artwork 3x4*	Filename of the 3x4 artwork
Artwork 16:9*	Filename of the 16x9 artwork
Artwork 4x3*	Filename of the 4x3 artwork
Artwork 16x9 Textless	Filename of the 16x9 textless artwork
Blocked Channels*	Semi colon separated list of channels to restrict delivery of titles, as defined in the Reference Lists.
License Types	List of types of licenses Filmhub can license to channels. One or more of: Ad-Supported; Transactional; Subscription
Territory restrictions	If the title is availed to only certain countries, designate whether the countries are included or excluded. One of: WORLDWIDE, ONLY, ALL EXCEPT
Countries	List of countries to apply the territory restriction to. Use the Reference Lists to look up country codes.
Avails Start Date	Date channels may start showing the title. YYYY-MM-DD
Avails End Date	Date channels must stop showing the title. YYYY-MM-DD