Creative Works Extends: CreativeWork

Movie Schema Markup

Movie markup enables rich movie information in Google Search, including ratings, cast, director, and release dates. It powers the Knowledge Panel for movies and feeds into Google's entertainment search features.

Generate Movie Markup View on Schema.org

Eligible Rich Results

Movie Knowledge Panel Movie Carousel

When to Use Movie

Movie review sites Streaming platforms Film databases Cinema websites

Properties

Property	Type	Status	Description
name	Text	required	The movie title.
director	Person	recommended	The film's director.
actor	Person (array)	optional	Cast members.
dateCreated	Date	optional	Release date.
description	Text	recommended	Movie synopsis.
image	URL	recommended	Movie poster.
duration	Duration	optional	Runtime in ISO 8601 format.
genre	Text	optional	Genre(s).
aggregateRating	AggregateRating	optional	Audience rating.
contentRating	Text	optional	MPAA rating (PG, PG-13, R, etc.).

JSON-LD Examples

Feature Film

A movie with director, cast, and rating.

{
  "@context": "https://schema.org",
  "@type": "Movie",
  "name": "The Code Breaker",
  "director": {
    "@type": "Person",
    "name": "James Park"
  },
  "actor": [
    {
      "@type": "Person",
      "name": "Sarah Chen"
    },
    {
      "@type": "Person",
      "name": "Michael Torres"
    }
  ],
  "dateCreated": "2024-06-15",
  "description": "A gripping thriller about a cybersecurity expert who uncovers a global conspiracy.",
  "genre": [
    "Thriller",
    "Sci-Fi"
  ],
  "duration": "PT2H15M",
  "contentRating": "PG-13",
  "image": "https://movies.com/code-breaker-poster.jpg",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "8.2",
    "bestRating": "10",
    "ratingCount": "15420"
  }
}

Common Mistakes

Using duration in human-readable format — must be ISO 8601 (PT2H15M, not '2h 15m').

Complete Guide to Movie Schema Markup

Movie schema markup feeds into Google's entertainment Knowledge Panels and movie-related search features. When properly implemented, movie pages can display ratings, cast, director, and runtime directly in search results.

Related Types

TVSeries VideoObject CreativeWork

Ready to Create Movie Markup?

Use our free generator to create valid Movie JSON-LD markup with a visual form. No coding required.

Open Generator