Movie
Mark up your movie lists with structured data so users can explore movies on Google Search in new ways. You can provide details about the movies, such as the title of the movie, director of the movie, and an image of the movie. The movie carousel is only available on mobile devices.

How to add structured data
Structured data is a standardized format for providing information about a page and classifying the page content. If you're new to structured data, you can learn more about how structured data works.
Here's an overview of how to build, test, and release structured data. For a step-by-step guide on how to add structured data to a web page, check out the structured data codelab.
- Add the required properties. Based on the format you're using, learn where to insert structured data on the page.
- Follow the guidelines.
- Validate your code using the Rich Results Test.
- Deploy a few pages that include your structured data and use the URL Inspection tool to test how Google sees the page. Be sure that your page is
accessible to Google and not blocked by a robots.txt file, the
noindex
tag, or login requirements. If the page looks okay, you can ask Google to recrawl your URLs. - To keep Google informed of future changes, we recommend that you submit a sitemap. You can automate this with the Search Console Sitemap API.
Examples
Summary page + multiple full details pages
The summary page has a short description of each item in the list, and each description points to a separate details page that is focused entirely on one item. Here's an example of the summary movie list in JSON-LD:
<html> <head> <title>The Best Movies from the Oscars - 2018</title> <script type="application/ld+json"> { "@context":"https://schema.org", "@type":"ItemList", "itemListElement":[ { "@type":"ListItem", "position":1, "url":"http://example.com/a-star-is-born.html" }, { "@type":"ListItem", "position":2, "url":"http://example.com/bohemian-rhapsody.html" }, { "@type":"ListItem", "position":3, "url":"http://example.com/black-panther.html" } ] } </script> </head> <body> </body> </html>
Single, all-in-one-page list
A single, all-in-one-page list hosts all list information, including full text of each item. Here's an example of a single, all-in-one movie list in JSON-LD:
<html> <head> <title>The Best Movies from the Oscars - 2018</title> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "ItemList", "itemListElement": [ { "@type": "ListItem", "position": "1", "item": { "@type": "Movie", "url": "https://example.com/2019-best-picture-noms#a-star-is-born", "name": "A Star Is Born", "image": "https://example.com/photos/6x9/photo.jpg", "dateCreated": "2018-10-05", "director": { "@type": "Person", "name": "Bradley Cooper" }, "review": { "@type": "Review", "reviewRating": { "@type": "Rating", "ratingValue": "5" }, "author": { "@type": "Person", "name": "John D." }, "reviewBody": "Heartbreaking, inpsiring, moving. Bradley Cooper is a triple threat." }, "aggregateRating": { "@type": "AggregateRating", "ratingValue": "90", "bestRating": "100", "ratingCount": "19141" } } }, { "@type": "ListItem", "position": "2", "item": { "@type": "Movie", "name": "Bohemian Rhapsody", "url": "https://example.com/2019-best-picture-noms#bohemian-rhapsody", "image": "https://example.com/photos/6x9/photo.jpg", "dateCreated": "2018-11-02", "director": { "@type": "Person", "name": "Bryan Singer" }, "review": { "@type": "Review", "reviewRating": { "@type": "Rating", "ratingValue": "3" }, "author": { "@type": "Person", "name": "Vin S." }, "reviewBody": "Rami Malek's performance is overrated, at best." }, "aggregateRating": { "@type": "AggregateRating", "ratingValue": "61", "bestRating": "100", "ratingCount": "21985" } } }, { "@type": "ListItem", "position": "3", "item": { "@type": "Movie", "name": "Black Panther", "url": "https://example.com/2019-best-picture-noms#black-panther", "image": "https://example.com/photos/6x9/photo.jpg", "dateCreated": "2018-02-16", "director": { "@type": "Person", "name": "Ryan Coogler" }, "review": { "@type": "Review", "reviewRating": { "@type": "Rating", "ratingValue": "2" }, "author": { "@type": "Person", "name": "Trevor R." }, "reviewBody": "I didn't like the lighting and CGI in this movie." }, "aggregateRating": { "@type": "AggregateRating", "ratingValue": "96", "bestRating": "100", "ratingCount": "88211" } } } ] } </script> </head> <body> </body> </html>
Guidelines
You must follow these guidelines to be eligible to appear in a movie carousel.
Structured data type definitions
You must include the required properties for your content to be eligible for display as a rich result. You can also include the recommended properties to add more information about your content, which could provide a better user experience.
Movie
In addition to the Carousel properties, define the following properties in your Carousel object.
The full definition of Movie
is available at
schema.org/Movie.
Required properties | |
---|---|
image |
URL or ImageObject
An image that represents the movie. Additional image guidelines:
|
name |
Text
The name of the movie. |
Recommended properties | |
---|---|
|
Annotation for the average review score assigned to the movie. Follow the Review snippet guidelines and list of required and recommended AggregateRating properties. |
dateCreated |
Date or DateTime
The date the movie was released. |
director |
Person
The director of the movie. For example: "director": { "@type": "Person", "name": "Bradley Cooper" } |
|
A nested |
Troubleshooting
If you're having trouble implementing or debugging structured data, here are some resources that may help you.
- You might have an error in your structured data. Check the list of structured data errors.
- If you received a structured data manual action against your page, the structured data on the page will be ignored (although the page can still appear in Google Search results). To fix structured data issues, use the Manual Actions report.
- Review the guidelines again to identify if your content isn't compliant with the guidelines.
- Troubleshoot missing rich results / drop in total rich results.
- For general questions about crawling and indexing, check the Google Search crawling and indexing FAQ.
- Ask a question in the Google Search Central office hours.
- Post a question in the Google Search Central forum.