MovieKit

MovieKit stores structured movie information, custom movie post types, field assignments and its own presentation profiles. Start with the first movie guide, then use the reference for the control you want to change.

• Create your first movie: register a movie type, choose its fields and publish a film.
• Settings and API keys: enter TMDb/OMDb credentials, choose rich data storage, scan existing fields and understand Cleanup.
• Setup and content types: register a MovieKit post type and choose shared WordPress taxonomies.
• Field Manager: assign movie fields, choose fetch sources and map destinations.
• Fields and taxonomies: look up every current field, its purpose and available API source choice.

MovieKit settings import/export moves selected configuration, not movies or WordPress media. See Import & export.

Getting Started and standalone display · MovieKit Profile in Elementor

MovieKit with MK Theme or another theme

Reference: MovieKit 2.9.72. MK Theme layouts are provided by the theme; this guide describes MovieKit setup and standalone display.

MovieKit → Setup and Getting Started show the active theme. MK Theme and its
child themes use the theme’s movie layouts; MovieKit automatic profile insertion
is disabled in that context to avoid duplicate profiles. Other themes use
MovieKit’s shortcodes, its Elementor Profile widget or optional automatic display.
Changing themes does not migrate or delete movie data.

Guided setup

Open MovieKit → Getting Started. New, unconfigured installations open here by
default. Existing sites keep their usual Settings landing page.

1. Choose a new collection or an existing public content type. New collections
   receive basic native film fields and Genres, Countries, Years, Directors and
   Actors. Existing content keeps its configuration unless you explicitly choose
   to add native fields. Existing Field Manager/ACF mappings are preserved.
2. Optionally supply TMDB or OMDb API keys. Manual movie entry works without keys.
   Blank inputs preserve existing keys. Setup does not call the providers.
3. Choose the profile style and display method, and optionally create a catalog
   draft. With MK Theme, use its layouts. With another theme, automatic display
   inserts a profile above the selected content type’s single-post content.
4. Review and finish. Changes are applied only at Finish. The optional catalog
   page is a draft; review and publish it yourself. Add your first film using
   the completion link, then enter data or fetch metadata in its editor.

You can rerun setup. An unchanged catalog draft made by the wizard is reused.
Edited or deleted pages are not overwritten; a new draft is created when needed.
Wizard configuration applies to one content type for automatic display. Field
Manager and manual shortcodes continue to support multiple types.

Automatic profiles are excluded from feeds, REST responses, secondary loops,
password-protected content and Elementor-built posts. A profile already inserted
manually is not duplicated. For custom layouts or Theme Builder templates, use
the Profile widget or a shortcode and leave automatic display off. Themes must
render normal WordPress post content for automatic insertion to appear.

Shortcodes without Elementor

Add a WordPress Shortcode block:

[movie_profile]
[movie_profile id="48" style="cinematic"]
[movie_profile name="my_profile"]
[movie_catalog post_type="movies" id="movies" per_page="12" columns="3"]

Profile layouts and saved profiles are described in MovieKit Profile in Elementor.
Elementor Free can use MovieKit Profile and the standard Shortcode widget.
Elementor is optional; MK Studio is optional for standalone MovieKit.

Catalog behavior

The catalog links cards to the movie’s normal permalink. Search covers WordPress
titles, excerpts and article text. It does not search actors/directors stored
only in taxonomy or meta fields. Genre and country filters follow Field Manager
taxonomy mappings. Filters mapped to plain meta fields are omitted. Year filtering
requires the native Years taxonomy and its synchronized four-digit movie_year
values; see the MovieKit Year Taxonomy batch-sync guide (advanced repair; ask support if no approved instructions are available) for older collections and ACF migrations.

Only published, publicly viewable content without a password appears, including
when an administrator previews the catalog. Invalid content types are rejected.
The result page size is bounded to 1–48, columns to 1–4. Smaller viewports use
two or one column. GET filter names are scoped to the shortcode’s id; use
different IDs for multiple catalogs on one page.

When using existing blog Posts, the catalog includes published Posts of the
chosen type; it does not infer which articles are movie reviews. Use a dedicated
movie collection when the blog also contains unrelated articles.

MovieKit profiles in Elementor

MovieKit 2.9.72 provides a native MovieKit Profile widget in the MovieKit
category. The widget and all eight layouts work with Elementor Free.

Enter a Post ID to display that film, or leave it empty to use the current
post. Inside a reusable single-post template, the current post must contain
MovieKit data. Use a film ID while designing an ordinary page. Protected posts
follow WordPress visitor access and password protection.

Under Template, choose Custom settings to set the layout, field switches,
accent and radius in the widget. Fields only shows controls supported by the
selected layout. A radius of 0 means square corners. Some layouts group the
year with the title or votes with the rating, so hiding the parent element
also removes those details from that location.

Choose Saved profile to select a preset created under MovieKit → Templates
→ My Profiles. Saved mode uses that profile’s layout, fields and appearance;
the widget’s custom controls are hidden and do not override the preset. The
film ID is still set separately in Data Source. Reload the editor after creating
a new preset in another tab. If a selected preset is deleted, the editor shows
a notice and the public widget stays empty until a valid preset is selected.

The eight layouts are Classic, Dark, TMDB, Cinematic, Card, Widget, Minimal and
Infobox. They are film-profile layouts, separate from Elementor page templates
and Theme Builder templates.

Shortcodes use the same renderer and configuration:

[movie_profile id="48" style="cinematic" title="yes" backdrop="yes" trailer="no" radius="0px"]
[movie_profile id="48" name="my_profile"]
[movie_profile id="48" name="my_profile" poster="no" accent="#2271b1"]

Explicit shortcode attributes override a saved profile. Supported field names
come from the profile field schema. Appearance attributes include accent,
radius, poster_width, font_size and actors_limit; colors must be hex values.

Templates → Preview and the My Profiles builder show the actual selected movie
using the same renderers. Theme typography can differ on the final page. The
preview does not save or import movie data. The eight profile layouts have real
previews; legacy mk_infobox variants retain their shortcodes and explicitly
request testing in a draft page instead of showing an unrelated mock.

Where Elementor’s dynamic-tag UI is available (normally Pro), use MovieKit
Poster Image or MovieKit Backdrop Image for an Image widget or an image
control. Existing Poster/Backdrop URL tags remain for link/URL controls. Review
uses MovieKit’s field mapping. Dynamic tags use the current post, rather than
the Post ID of a separate Profile widget.