Feature Film & Cinema Release Schema Markup (JSON-LD)
Structured data for theatrical feature films, streaming movies, cast and director credits, theatrical runtimes, production studio attributions, and official video trailers.
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": "Chronosphere: The Lost Dimension",
"director": {
"@type": "Person",
"name": "Denis Villeneuve-Harris",
"sameAs": "https://www.wikidata.org/wiki/Q1234567"
},
"actor": [
{
"@type": "Person",
"name": "Maya Hawke-Sterling"
},
{
"@type": "Person",
"name": "Dev Patel-Chen"
}
],
"duration": "PT2H18M",
"datePublished": "2026-11-20",
"genre": "Science Fiction / Mystery",
"productionCompany": {
"@type": "Organization",
"name": "Nexus Horizon Cinema",
"url": "https://omniseotools.com"
},
"trailer": {
"@type": "VideoObject",
"name": "Chronosphere Official Theatrical Trailer",
"embedUrl": "https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ",
"thumbnailUrl": "https://omniseotools.com/trailers/chronosphere-poster.jpg",
"uploadDate": "2026-09-01T12:00:00+00:00"
}
}Typed Properties Specification (8 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 | string | Required | Official title of the movie. e.g. Chronosphere: The Lost Dimension |
| director | Person | Person[] | Required | Principal director(s) credited for the feature film. e.g. { '@type': 'Person', 'name': 'Denis Villeneuve-Harris' } |
| actor | Person[] | Required | Primary cast members starring in the motion picture. e.g. [ { '@type': 'Person', 'name': 'Maya Hawke-Sterling' } ] |
| duration | string (ISO 8601 Duration) | Required | Total film runtime in ISO 8601 format (e.g. PT2H18M for 138 minutes). e.g. PT2H18M |
| productionCompany | Organization | Recommended | Film studio or production company financing and producing the movie. e.g. { '@type': 'Organization', 'name': 'Nexus Horizon Cinema' } |
| trailer | VideoObject | Recommended | Embedded official promotional video trailer object. e.g. { '@type': 'VideoObject', 'name': 'Official Trailer', 'embedUrl': '...' } |
| datePublished | string (ISO 8601) | Required | Global or domestic theatrical premiere release date. e.g. 2026-11-20 |
| genre | string | Recommended | Cinematic genre classification. e.g. Science Fiction / Mystery |
Google Search Console Pitfalls & Critical Warnings
Avoid these 3 common validation traps, parser errors, and algorithmic policy penalties when deploying Movie schema.
Missing VideoObject Nested Trailer Markup
Specifying trailer as a raw video URL string instead of a structured VideoObject node.
Format trailer as a nested VideoObject with name, embedUrl, and thumbnailUrl.
String-only Actor Array Instead of Person Nodes
Using plain string arrays for actors (e.g. 'actor': ['Dev Patel']) instead of Person objects.
Wrap each actor in a typed Person entity node.
Incorrect ISO 8601 Running Time
Formatting duration as '138 min' rather than 'PT2H18M'.
Use standard ISO 8601 duration notation (e.g. PT2H18M).
Recommended Implementation Scenarios
Related Schema Blueprints
Explore complementary structured data blueprints across the Media & Entertainment cluster.
TV Series & Broadcast Network Schema Markup (JSON-LD)
TV Episode & Season Hierarchy Schema Markup (JSON-LD)
Video Clip & Key Moment Segment Schema Markup (JSON-LD)
Video Tutorial & Streaming Media Schema Markup (JSON-LD)
Displayed below main page header or above the tool container. • Zero CLS Container