
Mark up your recipe content with structured data to provide rich results and host-specific lists for your recipes, such as reviewer ratings, cooking and preparation times, and nutrition information. Your page is eligible for different features depending on how you add structured data to your page:
- Search: Add recipe structured data to drive better engagement in Search with rich results.
- Guidance: Enable the Google Assistant to guide users through your recipes on Google Home and smart displays.
- Carousel: Add carousel structured data to enable your recipe to appear in a carousel of rich results. This can include images, page logos, and other interesting search result features.
- AMP: Build your recipe pages with AMP to provide instant-loading recipes.
By structuring your content according to this guide, your content may automatically enable the following features:
- Recipe badge in mobile image Search results
- Content action on the Google Assistant
Examples
Here are some examples of recipes using JSON-LD code in the Structured Data Testing Tool.
Recipe example
Here's an example of a page with recipe
and guidance structured data. This content can be eligible to be displayed as a rich result in Search results and guidance with the Google Assistant on Google Home and smart displays.
Carousel example
Here's an example of a recipe summary page (a page with a list of recipes) with itemList
structured data. This content can be eligible to be displayed in a carousel in Search results.
Guidelines
You must follow the general structured data guidelines for your recipe to be eligible to appear in Search results. To enable your recipe for guidance with Google Assistant on Google Home and smart displays, make sure your content follows the content restrictions policy for Actions on Google.
The following guidelines apply to recipe structured data.
- Use recipe structured data for content about preparing a particular dish. For example, "facial scrub" or "party ideas" are not valid names for a dish.
- To enable your recipes to appear in a host-specific list, you must follow these guidelines:
- Provide
ItemList
structured data to summarize the recipes for your list. You can provideItemList
structured data separately or together with recipe structured data. - Your site must have a summary page that lists all the recipes in the collection. For example, when a user clicks the summary link from Search results, they are properly directed to a page on your site listing the recipes related to their search.
- Provide
Structured data type definitions
You must include the required properties for your content to be eligible for display as a rich result or other experiences on Google. You can also include the recommended properties to add more information about your content, which could provide a better user experience.
ItemList
The full definition of ItemList
is
available at schema.org/ItemList.
In addition to Recipe properties, add the following properties for
host-specific lists. While ItemList
isn't required,
you must add the following properties if you want your recipe to be eligible for a
host carousel. For more information about host-specific lists, see
Carousel.
Required properties | |
---|---|
itemListElement |
Annotation for a single item page. |
ListItem.position |
Ordinal position of the item page in the list. For example: "itemListElement": [ { "@type": "ListItem", "position": 1, }, { "@type": "ListItem", "position": 2, } ] |
ListItem.url |
The canonical URL of the item page. Every item should have a unique URL. |
Recipe
The full definition of Recipe
is available at
schema.org/Recipe.
Mark up your recipe content with the following properties of the
schema.org Recipe type. In addition to the required fields,
mark up as many of the recommended fields as possible to drive better engagement in Search.
To enable your recipe for guidance with the Google Assistant on Google Home and smart displays, make sure you
add recipeIngredient
and recipeInstructions
. If your recipe doesn't have these properties, the recipe isn't eligible for guidance, but may still be eligible to appear in Search results.
Required properties | |
---|---|
image |
URL or ImageObject Image of the completed dish. Additional image guidelines:
For example: "image": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ] |
name |
The name of the dish. |
Recommended properties | |
---|---|
aggregateRating |
Annotation for the average review score assigned to the item. Follow the Review snippet guidelines and list of required and recommended AggregateRating properties. If the recipe structured data contains a single review, the reviewer’s name must be a valid person or organization. For example, "50% off ingredients" is not a valid name for a reviewer. |
author |
Creator of the recipe. |
cookTime |
The time it takes to actually cook the dish in ISO 8601 format. You can use min and max as child elements to specify a range of time. Always use in combination with |
datePublished |
The date the recipe was published in ISO 8601 format. |
description |
A short summary describing the dish. |
keywords |
Other terms for your recipe such as the season (“summer”), the holiday (“Halloween“), or other descriptors (“quick”, “easy”, “authentic”). Additional guidelines
|
nutrition.calories |
The number of calories in each serving. |
prepTime |
The length of time it takes to prepare the dish, in ISO 8601 format. You can use min and max as child elements to specify a range of time. Always use in combination with |
recipeCategory |
The type of meal or course your recipe is about. For example: "dinner", "entree", or "dessert, snack". |
recipeCuisine |
The region associated with your recipe. For example, "French", Mediterranean", or "American". |
recipeIngredient |
An ingredient used in the recipe. This property is recommended for recipes on Google Search, but it's required for guidance with the Google Assistant on Google Home and smart displays. For example: "recipeIngredient": [ "1 box Pillsbury dough", "6 cups thinly sliced, peeled apples (6 medium)", "3/4 cup sugar", "2 tablespoons all-purpose flour", "3/4 teaspoon ground cinnamon", "1/4 teaspoon salt", "1/8 teaspoon ground nutmeg", "1 tablespoon lemon juice" ] Additional guidelines:
|
recipeInstructions |
The steps to make the dish. This property is recommended for recipes on Google Search, but it's required for guidance with the Google Assistant on Google Home and smart displays. There are several options for setting the value of
Additional guidelines
|
recipeYield |
The quantity produced by the recipe. For example: number of people served, or number of servings. |
review |
A review of the dish. Follow the Review snippet guidelines and the list of required and recommended review properties. |
totalTime |
The total time it takes to prepare the cook the dish, in ISO 8601 format. You can use min and max as child elements to specify a range of time. Use |
video |
An array of video properties that depict the recipe on the page. Follow the list of required and recommended Video properties. Here's an example: { "@context": "https://schema.org/", "@type": "Recipe", "video": [ { "name": "Party Coffee Cake", "description": "How to make Party Coffee Cake.", "thumbnailUrl": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ], "contentUrl": "http://www.example.com/videos/123_600x400.mp4", "embedUrl": "http://www.example.com/videoplayer?id=123", "uploadDate": "2018-02-05T08:00:00+08:00" } ] } |