Movie & Cinema Release Schema (JSON-LD Blueprint)
Structured data for feature films, documentaries, and cinematic releases with director, cast, trailer video, and aggregate ratings.
Displayed below main page header or above the tool container. • Zero CLS Container
Production JSON-LD Code Block
Embed this structured data block directly into your HTML <head> or framework layout template.
{
"@context": "https://schema.org",
"@type": "Movie",
"name": "Silicon Horizon",
"image": "https://omniseotools.com/images/movies/silicon-horizon-poster.jpg",
"director": {
"@type": "Person",
"name": "Elena Rostova"
},
"actor": [
{
"@type": "Person",
"name": "David Chen"
},
{
"@type": "Person",
"name": "Maya Lin"
}
],
"dateCreated": "2026-01-10",
"duration": "PT1H54M",
"trailer": {
"@type": "VideoObject",
"name": "Official Theatrical Trailer",
"embedUrl": "https://www.youtube.com/embed/exampleTrailer",
"thumbnailUrl": "https://omniseotools.com/images/movies/trailer-thumb.jpg",
"uploadDate": "2025-11-20"
},
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "8.4",
"bestRating": "10",
"ratingCount": "18400"
}
}Typed Properties Specification (7 Fields)
Key Schema.org properties and sub-objects required to qualify for rich snippet treatment in Google Search.
| Property | Expected Type | Status | Description & Example |
|---|---|---|---|
| name | Text | Required | Official theatrical title. e.g. Silicon Horizon |
| director | Person | Array<Person> | Required | Film director(s). e.g. { "@type": "Person", "name": "..." } |
| actor | Array<Person> | Recommended | Principal cast actors. e.g. [{ "@type": "Person", "name": "..." }] |
| duration | Duration | Required | Runtime in ISO 8601 duration format (e.g. PT1H54M). e.g. PT1H54M |
| trailer | VideoObject | Recommended | Official teaser or trailer stream. e.g. { "@type": "VideoObject", ... } |
| dateCreated | Date | Recommended | Production completion year/date. e.g. 2026-01-10 |
| productionCompany | Organization | Recommended | Film studio or production house. e.g. { "@type": "Organization", "name": "Horizon Pictures" } |
Google Search Console Pitfalls & Critical Warnings
Avoid these 3 common validation traps, parser errors, and algorithmic policy penalties when deploying Movie schema.
Missing Trailer VideoObject Thumbnail
Embedding trailer without thumbnailUrl causes video embed parser crash.
Always supply complete VideoObject for trailer.
Invalid Duration Format ('114 mins')
Using plain language duration instead of ISO 8601 'PT1H54M'.
Use ISO 8601 duration format.
Rating Scale Exceeding Declared Range
Providing ratingValue of '8.4' without declaring bestRating: '10' causes Google to default bestRating to '5', triggering an error.
Explicitly declare bestRating: '10' for 10-point IMDB-style scales.
Recommended Implementation Scenarios
Related Schema Blueprints
Explore complementary structured data blueprints across the Creative Work & Media cluster.
Displayed below main page header or above the tool container. • Zero CLS Container