Movie schema markup enables movie carousel rich results in Google Search — showing film title, image, ratings, and director in visually prominent search results. Movie structured data is used by film databases, streaming platforms, and review sites. Valid Movie schema with aggregateRating can trigger star ratings alongside movie titles in search.
| Property | Type | Description |
|---|---|---|
namerich result | string | The title of the movie. |
Missing recommended properties generate warnings. They won't block validation, but rich result-tagged properties are needed for full Google rich result eligibility.
| Property | Type | Description |
|---|---|---|
imagerich result | URL or ImageObject | Movie poster or promotional image. Required for carousel rich results. |
description | string | A synopsis of the movie. |
dateCreated | ISO 8601 date | The release date of the movie. |
director | Person | The director of the movie. |
actor | Person array | The cast members. |
aggregateRatingrich result | AggregateRating | Overall audience or critic rating. Required for star ratings. |
contentRating | string | The MPAA content rating (e.g. PG-13, R). |
url | URL | The canonical URL for this movie page. |
Rich result type: Movie carousel rich result
Requirements: Required: name. image and aggregateRating are needed for full rich results. director and dateCreated add context.
{
"@context": "https://schema.org",
"@type": "Movie",
"name": "The Data Architect",
"image": "https://example.com/images/movie-poster.jpg",
"description": "A thriller about a data scientist who discovers a global surveillance conspiracy.",
"dateCreated": "2026-01-15",
"director": {
"@type": "Person",
"name": "Alex Chen"
},
"actor": [
{
"@type": "Person",
"name": "Jordan Taylor"
},
{
"@type": "Person",
"name": "Sam Rivera"
}
],
"contentRating": "PG-13",
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "7.8",
"reviewCount": "4312",
"bestRating": "10"
},
"url": "https://example.com/movies/the-data-architect"
}Validate this schema against Google's requirements in one API call:
curl "https://schemacheck.dev/api/v1/validate" \
-H "x-api-key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonld":{"@context":"https://schema.org","@type":"Movie","name":"The Data Architect","image":"https://example.com/images/movie-poster.jpg","description":"A thriller about a data scientist who discovers a global surveillance conspiracy.","dateCreated":"2026-01-15","director":{"@type":"Person","name":"Alex Chen"},"actor":[{"@type":"Person","name":"Jordan Taylor"},{"@type":"Person","name":"Sam Rivera"}],"contentRating":"PG-13","aggregateRating":{"@type":"AggregateRating","ratingValue":"7.8","reviewCount":"4312","bestRating":"10"},"url":"https://example.com/movies/the-data-architect"}}'100 free validations/month. No credit card required.