MK SYSTEM / DOCUMENTATION

MovieKit fields and taxonomies

MovieKit fields store structured film details, while taxonomies group movies by shared attributes such as genre and year.

Location: WordPress admin → MovieKit → Field Manager. Updated for: MovieKit 2.9.66. This is the complete list of field definitions shown by the current Field Manager: 12 taxonomies and 35 meta fields. The post type you select determines which of them are active in its editor.

The API choice column describes the per-field Data source menu, not a promise that a provider will return a value for every title. Both means Default, TMDB only, OMDB only and Skip are available; TMDb or OMDb means that provider and Skip are available; None means no per-field source menu appears. Enter credentials in MovieKit Settings, then configure assignments and destinations in Field Manager.

Taxonomies

Taxonomies organize movies into reusable terms. Enabling a taxonomy makes it available to the selected content type; the choice is separate from shared WordPress Categories and Tags in MovieKit Setup.

Field / keyUseAPI choice
Genres
movie_genres
Genre terms such as drama or comedy.Both
Directors
movie_directors
Director names as terms.TMDb
Writers
movie_writers
Writer names as terms.Both
Actors
movie_actors
Cast names as terms.Both
Countries
movie_countries
Countries associated with a title.Both
Languages
movie_languages
Language terms for catalog organization.Both
Production Companies
movie_production_companies
Company names as terms.TMDb
Keywords
movie_keywords
Topic keywords supplied as terms.TMDb
Type
movie_type
Movie or TV content classification from the data source.TMDb
Status
movie_status
Production or release status, separate from WordPress Published/Draft status.TMDb
TV Networks
movie_networks
Networks associated with a TV title.TMDb
Years
movie_year
Year terms for archive/filter organization. The Year meta value can generate the corresponding term.Both

Basic Info

Field / keyUseAPI choice
Title
movie_title
Movie title field. A fetched title also supplies the WordPress post title in the supported draft flow.Both
Original Title
movie_original_title
Title in the source’s original form or language.TMDb
Year
movie_year
Single year value saved with the movie; distinct from the Years taxonomy.Both
Release Date
movie_release_date
Release date as displayed text.Both
Release Date ISO
movie_release_date_iso
Machine-friendly ISO form of the release date.TMDb
Runtime
movie_runtime
Running time shown as text.Both

Plot & Details

Field / keyUseAPI choice
Plot / Overview
movie_plot
Summary of the story.Both
Review
movie_review
Your editorial review; MovieKit’s film database fetch does not supply it.None
Tagline
movie_tagline
Short promotional phrase.TMDb
Rated (MPAA)
movie_rated
Content rating returned by OMDb, when available.OMDb
Awards
movie_awards
Awards text returned by OMDb.OMDb

Ratings & Stats

Field / keyUseAPI choice
Rating
movie_rating
Source rating value. Check the selected fetch source before comparing ratings.Both
IMDB Votes
movie_imdb_votes
IMDb vote count supplied by OMDb.OMDb
Popularity Score
movie_popularity
TMDb popularity value.TMDb
Vote Count
movie_vote_count
TMDb vote count.TMDb

Finance

Field / keyUseAPI choice
Budget $
movie_budget
Budget text from TMDb, when reported.TMDb
Revenue $
movie_revenue
Revenue text from TMDb, when reported.TMDb
Box Office
movie_box_office
Box office text from OMDb.OMDb

IDs & Links

Field / keyUseAPI choice
IMDB ID
movie_imdb_id
IMDb identifier, such as tt...; used for supported fetch lookups.TMDb
TMDB ID
movie_tmdb_id
TMDb identifier for the movie or TV record.TMDb
Original Language Code
movie_original_language
Original-language code from TMDb.TMDb

Images

These are URLs, not uploaded WordPress media files. Image values can be entered manually or supplied by a supported fetch/image workflow. These four rows do not show an individual Data source selector in the current Field Manager.

Field / keyUse
Poster URL
movie_poster_url
Poster image URL used by movie displays.
Poster URL Original
movie_poster_url_original
Original-size poster URL.
Backdrop URL 1280
movie_backdrop_url
Backdrop URL at the 1280-size variant when provided.
Backdrop URL Original
movie_backdrop_url_original
Original-size backdrop URL.

Trailer & Teaser

Each trailer or teaser has three related values. A Watch URL points to the public video page; an ID is the provider’s video identifier; an Embed URL is for an embedded player. The MovieKit fields are distinct from MK Theme’s dedicated Watch / Video URL override.

Field / keyUseAPI choice
Trailer – YouTube Watch URL
movie_trailer_url
Trailer watch-page URL.TMDb
Trailer – YouTube ID
movie_trailer_id
Trailer video identifier.TMDb
Trailer – Embed URL
movie_trailer_embed
Trailer player URL.TMDb
Teaser – YouTube Watch URL
movie_teaser_url
Teaser watch-page URL.TMDb
Teaser – YouTube ID
movie_teaser_id
Teaser video identifier.TMDb
Teaser – Embed URL
movie_teaser_embed
Teaser player URL.TMDb

TV Series

Field / keyUseAPI choice
Number of Seasons
movie_seasons
Reported season count.TMDb
Number of Episodes
movie_episodes
Reported episode count.TMDb
First Air Date
movie_first_air_date
First TV air date.TMDb
Last Air Date
movie_last_air_date
Last TV air date.TMDb

Changing a Field Manager assignment does not run a fetch or erase saved content. Read the Field Manager reference before using destination mapping or Hard delete.