Movie

Movie schema describes a film with structured metadata that search engines use to power movie carousels, knowledge panels, and rich results in Google Search. It covers the core metadata that identifies a movie: title, director, cast, release date, and content rating.

When to use Movie

Use this type when the page is about a specific film. This includes movie review pages, film database entries, streaming platform listings, and cinema showtimes. For TV shows, use TVSeries. For individual episodes, use Episode.

Google support

Google supports Movie structured data for movie carousel rich results. Movies marked up with schema.org properties can appear in the movie carousel in Google Search, showing poster images, ratings, and release dates.

Fields

Recommended

• dateCreated — The theatrical release date
• director — The film's director

Optional

• actor — Cast members appearing in the film
• contentRating — MPAA or equivalent age/content rating

Movie also inherits properties from CreativeWork, including name, image, description, aggregateRating, review, and url.

JSON-LD example

{
  "@context": "https://schema.org",
  "@type": "Movie",
  "name": "Inception",
  "director": {
    "@type": "Person",
    "name": "Christopher Nolan"
  },
  "actor": [
    {"@type": "Person", "name": "Leonardo DiCaprio"},
    {"@type": "Person", "name": "Joseph Gordon-Levitt"},
    {"@type": "Person", "name": "Elliot Page"},
    {"@type": "Person", "name": "Tom Hardy"}
  ],
  "dateCreated": "2010-07-16",
  "contentRating": "PG-13",
  "image": "https://example.com/inception-poster.jpg",
  "description": "A thief who steals corporate secrets through dream-sharing technology is given the inverse task of planting an idea into the mind of a C.E.O.",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": 87,
    "bestRating": 100,
    "ratingCount": 363
  }
}

Webflow implementation

For Webflow movie database or review sites, add Movie markup in Page Settings > Custom Code or through CMS template embeds. Include at minimum name, director, dateCreated, and image. Adding actor and aggregateRating strengthens the markup for carousel eligibility.

Schema HQ automates Movie markup for Webflow CMS template pages, mapping collection fields to the correct schema.org properties including nested Person objects for director and actor.