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.