---
title: Movie Structured Data — Quick Guide
description: "## What is Movie Structured Data? - Markup that describes a movie, its details, and related info on your webpage. - Helps Google display rich results for movies in Search, like ratings, release dates, cast, and trailers. ## Who Should…"
url: "https://fsidm.in/knowledge/seo/movie-structured-data/"
updated: "2025-11-30"
category: SEO
---

# Movie Structured Data — Quick Guide

## What is Movie Structured Data?

- Markup that describes a movie, its details, and related info on your webpage.
- Helps Google display rich results for movies in Search, like ratings, release dates, cast, and trailers.

## Who Should Use It?

- Movie review sites
- Film studios and distributors
- Cinema and streaming platforms
- Any site with movie details or listings

## Required & Recommended Properties

| **Property** | **Description** | **Required/Recommended** |
| --- | --- | --- |
| @context | Always "https://schema.org" | Required |
| @type | Must be "Movie" | Required |
| name | Movie title | Required |
| image | Poster or movie image URL | Recommended |
| description | Short description or synopsis | Recommended |
| datePublished | Release date (ISO format) | Recommended |
| director | Person or Organization who directed the movie | Recommended |
| actor | Cast members (Person objects) | Recommended |
| aggregateRating | Average rating with count | Recommended (if available) |
| trailer | VideoObject representing the trailer | Recommended |
| genre | Genre of the movie (string or array) | Recommended |

### **Example JSON-LD for Movie**

<script type="application/ld+json">

{

  "@context": "https://schema.org",

  "@type": "Movie",

  "name": "3 Idiots",

  "image": "https://example.com/posters/3idiots.jpg",

  "description": "A story about the friendship of three engineering students and their journey through college.",

  "datePublished": "2009-12-25",

  "director": {

    "@type": "Person",

    "name": "Rajkumar Hirani"

  },

  "actor": \[

    {

      "@type": "Person",

      "name": "Aamir Khan"

    },

    {

      "@type": "Person",

      "name": "R. Madhavan"

    },

    {

      "@type": "Person",

      "name": "Sharman Joshi"

    }

  \],

  "aggregateRating": {

    "@type": "AggregateRating",

    "ratingValue": "8.4",

    "ratingCount": "12500"

  },

  "genre": \["Comedy", "Drama"\],

  "trailer": {

    "@type": "VideoObject",

    "name": "3 Idiots Official Trailer",

    "thumbnailUrl": "https://example.com/thumbnails/3idiots-trailer.jpg",

    "uploadDate": "2009-11-01",

    "contentUrl": "https://example.com/videos/3idiots-trailer.mp4",

    "embedUrl": "https://www.youtube.com/embed/xyz123"

  }

}

</script>

## Best Practices

- Always include the movie title (name).
- Provide a valid datePublished in ISO format.
- Add cast (actor) and director details for richer results.
- Use a high-quality image for the poster.
- Include aggregateRating if you have user or critic ratings.
- Provide trailer info as VideoObject if available.
- Test markup with Rich Results Test.
- Ensure content is visible on the page and accurate.