Movie Structured Data: Complete Implementation Guide

Why Use Movie Schema?

• Display rich film panels in search results featuring poster images, ratings, cast, and release information.
• Improve click-through rates by presenting key film details — such as genre, duration, and director — directly in the search listing.
• Help Google understand relationships between films, actors, and directors, increasing your chances of appearing in knowledge panel carousels.
• Support voice assistant queries like 'What films has Christopher Nolan directed?' by providing machine-readable filmography data.
• Enhance your content's eligibility for Google's movie carousel and other entertainment-focused search features.

Required Properties

These properties are required by Google for Movie structured data to be eligible for rich results.

Recommended Properties

Adding these properties improves your chances of appearing in rich results and provides more context to search engines.

JSON-LD Example

Here is a complete Movie structured data example you can use as a starting point. Or use our Movie generator to create one automatically.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Movie",
  "name": "The Midnight Clockmaker",
  "image": "https://www.examplefilms.co.uk/posters/midnight-clockmaker.jpg",
  "description": "A reclusive clockmaker in Victorian London discovers that the timepieces he restores hold fragments of their owners' memories, drawing him into a mystery that spans decades.",
  "director": {
    "@type": "Person",
    "name": "Eleanor Whitfield"
  },
  "actor": [
    {
      "@type": "Person",
      "name": "James Harrington"
    },
    {
      "@type": "Person",
      "name": "Priya Kapoor"
    },
    {
      "@type": "Person",
      "name": "David Okonkwo"
    }
  ],
  "dateCreated": "2025-11-14",
  "genre": [
    "Drama",
    "Mystery"
  ],
  "duration": "PT127M",
  "contentRating": "12A",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.3",
    "bestRating": "5",
    "ratingCount": 8420
  },
  "review": {
    "@type": "Review",
    "author": {
      "@type": "Person",
      "name": "Marcus Webb"
    },
    "reviewRating": {
      "@type": "Rating",
      "ratingValue": "4",
      "bestRating": "5"
    },
    "reviewBody": "A beautifully crafted period mystery with outstanding performances. Whitfield's direction is assured and the central conceit never feels contrived."
  }
}
</script>

How to Implement Movie Schema

1. 1Add a JSON-LD script block to each individual film page on your site. Each page should contain exactly one Movie object.
2. 2Set the name to the official film title and include a high-quality poster image URL in the image property.
3. 3Add director and actor properties using Person objects. For well-known individuals, consider adding a sameAs property linking to their official website or social profile.
4. 4Include the release date in dateCreated and the runtime in duration using ISO 8601 format.
5. 5If your site collects user ratings, add an aggregateRating object with the current average, scale, and total number of ratings.
6. 6Validate your markup using Google's Rich Results Test. Check that the poster image loads correctly and that all Person names are spelled accurately.

Common Mistakes to Avoid

• Using a low-resolution or incorrectly cropped poster image — Google recommends high-quality images of at least 160x90 pixels, though larger is always better.
• Omitting the director property, which is one of the key signals Google uses to match your content to film-related queries.
• Providing an aggregateRating that does not reflect genuine user reviews collected on your own site — fabricated or imported ratings violate Google's guidelines.
• Listing every cast member rather than focusing on the principal actors — keep the actor array to the 3-5 most prominent roles for clarity.
• Using inconsistent film titles across structured data, page headings, and metadata, which confuses search engines about canonical naming.

Testing & Validation

Before deploying your Movie structured data, validate it using these tools:

1. 1Google Rich Results Test — Paste your page URL or code snippet to check if your structured data is eligible for rich results.
2. 2Schema Markup Validator — Validates your JSON-LD syntax against the schema.org specification.
3. 3Google Search Console — After deployment, monitor the Enhancements report for any errors or warnings.

Frequently Asked Questions