Recipes

Mark up your recipe content with structured data to provide rich cards and host-specific lists for your recipes, such as reviewer ratings, cooking and preparation times, and nutrition information.

Use Cases

A query such as “mango recipes” <script type="application/ld+json"> { "@context": "http://schema.org/", "@type": "Recipe", "name": "Strawberry-Mango Mesclun Recipe", "image": "http://images.media-allrecipes.com/userphotos/600x600/1116471.jpg", "author": { "@type": "Person", "name": "scoopnana" }, "datePublished": "2008-03-03", "description": "Mango, strawberries, and sweetened dried cranberries are a vibrant addition to mixed greens tossed with an oil and balsamic vinegar dressing.", "aggregateRating": { "@type": "AggregateRating", "ratingValue": "5", "reviewCount": "52" }, "prepTime": "PT15M", "totalTime": "PT14M", "recipeYield": "12 servings", "nutrition": { "@type": "NutritionInformation", "servingSize": "1 bowl", "calories": "319 cal", "fatContent": "20.2 g" }, "recipeIngredient": [ "1/2 cup sugar", "3/4 cup canola oil", "1 teaspoon salt", "1/4 cup balsamic vinegar", "8 cups mixed salad greens", "2 cups sweetened dried cranberries", "1/2 pound fresh strawberries, quartered", "1 mango - peeled, seeded, and cubed", "1/2 cup chopped onion", "1 cup slivered almonds" ], "recipeInstructions": "\n1. Place the sugar, oil, salt, and vinegar in a jar with a lid. Seal jar, and shake vigorously to mix.\n2. In a large bowl, mix salad greens, sweetened dried cranberries, strawberries, mango, and onion. To serve, toss with dressing and sprinkle with almonds." } </script>

A query such as “grandmas holiday apple pie” <script type="application/ld+json"> { "@context": "http://schema.org/", "@type": "Recipe", "name": "Perfect Apple Pie", "author": "Gin Blanco", "image": "http://images.edge-generalmills.com/56459281-6fe6-4d9d-984f-385c9488d824.jpg", "description": "A classic apple pie takes a shortcut with easy Pillsbury® unroll-fill refrigerated pie crust.", "aggregateRating": { "@type": "AggregateRating", "ratingValue": "4.5", "reviewCount": "276", "bestRating": "5", "worstRating": "1" }, "prepTime": "PT30M", "totalTime": "PT3H", "recipeYield": "8", "nutrition": { "@type": "NutritionInformation", "servingSize": "1 medium slice", "calories": "230 calories", "fatContent": "1 g", "carbohydrateContent": "43 g", "cholesterolContent": "0 mg", "fiberContent": "1 g", "proteinContent": "1 g", "saturatedFatContent": "2 ½ g", "servingSize": "1 Serving", "sodiumContent": "200 mg", "sugarContent": "27 g", "transFatContent": "0 g" }, "recipeIngredient": [ "1 box Pillsbury™ refrigerated pie crusts, softened as directed on box", "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" ], "recipeInstructions": [ "1 Heat oven to 425°F. Place 1 pie crust in ungreased 9-inch glass pie plate. Press firmly against side and bottom.", "2 In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate. Top with second crust. Wrap excess top crust under bottom crust edge, pressing edges together to seal; flute. Cut slits or shapes in several places in top crust.", "3 Bake 40 to 45 minutes or until apples are tender and crust is golden brown. Cover edge of crust with 2- to 3-inch wide strips of foil after first 15 to 20 minutes of baking to prevent excessive browning. Cool on cooling rack at least 2 hours before serving." ] } </script>

A query such as "great chicken recipes" <script type="application/ld+json"> { "@context": "http://schema.org", "@type": "ItemList", "itemListElement": [ { "@type": "ListItem", "position": 1, "item": { "@type": "Recipe", "url": "http://example.com/desserts/pies/#apple-pie", "name": "Apple Pie", "image": "https://example.com/300px-Apple_pie.jpg", "author": { "@type": "Person", "name": "Carol Smith" }, "datePublished": "2009-11-05" } }, { "@type": "ListItem", "position": 2, "item": { "@type": "Recipe", "url": "http://example.com/desserts/pies/#cherry-pie", "name": "Cherry Pie", "image": "http://www.example.com/images/cherry.jpg", "author": { "@type": "Person", "name": "Carol Smith" }, "datePublished": "2009-11-05" } }, { "@type": "ListItem", "position": 3, "item": { "@type" : "Recipe", "url":"http://example.com/desserts/pies/#blueberry-pie", "name": "Blueberry Pie", "image": "http://www.example.com/images/blueberry.jpg", "author": { "@type": "Person", "name": "Carol Smith" }, "datePublished": "2009-11-05" } } ] } </script>

Guidelines

In addition to the general policies that apply to all Rich Cards, the following extra policies apply for recipe Rich Cards:

• Use recipe markup for content about preparing a particular dish. For example, "facial scrub" or "party ideas" are not valid names for a dish.
• Use recipe property markup for a single recipe, not a category of recipes or a list of recipes. For example, “10 apple pie recipes” is not a single recipe. See also policies regarding multiple entities on the same page.
• If the recipe markup 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.
• To enable your recipes to appear in a host-specific list, you must provide ItemList markup to summarize the recipes for your list. You can provide ItemList markup separately or together with Recipe markup. See Mark Up Your Lists for details.
• For host-specific lists, your site must have a summary page that lists all the recipes in the collection, so that 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.

Type Definitions

ItemList Properties

The following table indicates the ItemList properties necessary for host-specific lists. See specific guidelines above and Mark Up Your Listings for implementation details.

Property
itemListElement	ListItem, required Annotation for a single item page.
ListItem.position	Integer, required Ordinal position of the item page in the list.
ListItem.url	URL, required The canonical URL of the item page. Every item should have a unique URL.

Recipe Properties

When you mark up your recipe content, use the following properties of the schema.org Recipe type. The table below indicates those properties that are required in order for your content to be eligible for rich cards. Mark up as many of the recommended fields as possible; this maximizes your rich content opportunities and drives better engagement in Search.

Properties
name	Text, required The name of the dish.
recipeCategory	Text, recommended The type of dish. For example: appetizer, entree, or dessert.
image	URL or ImageObject, required Image of the completed dish.
datePublished	Date, recommended The date the recipe was published, in ISO 8601 format.
description	Text, recommended A short summary describing the dish.
aggregateRating	AggregateRating, recommended Annotation for the average review score assigned to the item.
review	Review, recommended A review of the dish. Can include nested review information.
prepTime	Duration, recommended* The length of time it takes to prepare the recipe for dish, in ISO 8601 format. Can use min, max as child elements to specify a range of time. *Always use in combination with cookTime.
cookTime	Duration, recommended* The time it takes to actually cook the dish, in ISO 8601 format. Can usemin, max as child elements to specify a range of time. *Always use in combination with prepTime.
totalTime	Duration, recommended* The total time it takes to prepare the cook the dish, in ISO 8601 format. Can use min, max as child elements to specify a range of time. * Use totalTime or a combination of both cookTime and prepTime.
nutrition.calories	Energy, recommended The number of calories in the recipe.
recipeInstructions	Text, recommended The steps to make the dish. Can contain the child element instruction, which can be used to annotate each step.
recipeYield	Text, recommended The quantity produced by the recipe. For example: number of people served, or number of servings.
recipeIngredient	Text, recommended An ingredient used in the recipe.
author	Person, recommended Creator of the recipe.