Recipe (Recipe, HowTo, ItemList) structured data

URL or ImageObject

Image of the completed dish.

Additional image guidelines:

• Image URLs must be crawlable and indexable. To check if Google can access your URLs, use the URL Inspection tool.
• Images must represent the marked up content.
• Images must be in a file format that's supported by Google Images.
• For best results, we recommend providing multiple high-resolution images (minimum of 50K pixels when multiplying width and height) with the following aspect ratios: 16x9, 4x3, and 1x1.

For example:

"image": [
  "https://example.com/photos/1x1/photo.jpg",
  "https://example.com/photos/4x3/photo.jpg",
  "https://example.com/photos/16x9/photo.jpg"
]

Text

The name of the dish.

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.

Person or Organization

The name of the person or organization that wrote the recipe. To help Google best understand authors across various features, consider following the author markup best practices.

Duration

The time it takes to actually cook the dish in ISO 8601 format, if applicable.

Always use in combination with prepTime.

Date

The date the recipe was published in ISO 8601 format, if applicable.

Text

A short summary describing the dish.

Text

Other terms for your recipe such as the season ("summer"), the holiday ("Halloween"), or other descriptors ("quick", "easy", "authentic").

Additional guidelines

• Separate multiple entries in a keywords list with commas.
• Don't use a tag that's actually a recipeCategory or recipeCuisine.
  

  Not recommended:

  "keywords": "dessert, American"

  Recommended:

  "keywords": "winter apple pie, nutmeg crust"

Energy

The number of calories in each serving produced with this recipe. If nutrition.calories is defined, recipeYield must be defined with the number of servings.

Duration

The length of time it takes to prepare ingredients and workspace for the dish, in ISO 8601 format, if applicable.

Always use in combination with cookTime.

Text

The type of meal or course your recipe is about. For example: "dinner", "main course", or "dessert, snack".

Text

The region associated with your recipe. For example, "French", Mediterranean", or "American".

Text

An ingredient used in the recipe.

For example:

"recipeIngredient": [
  "1 (15 ounce) package double crust ready-to-use pie crust",
  "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:

• Include only the ingredient text that is necessary for making the recipe.
• Don't include unnecessary information, such as a definition of the ingredient.

HowToStep, HowToSection, or Text

The steps to make the dish.

There are several options for setting the value of recipeInstructions. We recommend using HowToStep. HowToSection can also be used to group HowToSteps when the recipe has sections.

• HowToStep: Specify this recipe's steps with HowToStep.

  "recipeInstructions": [
    {
      "@type": "HowToStep",
      "name": "Preheat",
      "text": "Heat oven to 425°F.",
      "url": "https://example.com/recipe#step1",
      "image": "https://example.com/photos/recipe/step1.jpg"
    }, {
      "@type": "HowToStep",
      "name": "Prepare crust",
      "text": "Place 1 pie crust in ungreased 9-inch glass pie plate, pressing firmly against side and bottom.",
      "url": "https://example.com/recipe#step2",
      "image": "https://example.com/photos/recipe/step2.jpg"
    }, {
      "@type": "HowToStep",
      "name": "Make filling",
      "text": "In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate.",
      "url": "https://example.com/recipe#step3",
      "image": "https://example.com/photos/recipe/step3.jpg"
    }, {
      "@type": "HowToStep",
      "name": "Cover",
      "text": "Top with second crust. Cut slits or shapes in several places in top crust.",
      "url": "https://example.com/recipe#step4",
      "image": "https://example.com/photos/recipe/step4.jpg"
    }, {
      "@type": "HowToStep",
      "name": "Bake",
      "text": "Bake 40 to 45 minutes. The pie is ready when the apples are tender and the crust is golden brown.",
      "url": "https://example.com/recipe#step5",
      "image": "https://example.com/photos/recipe/step5.jpg"
    }, {
      "@type": "HowToStep",
      "name": "Cool",
      "text": "Cool on cooling rack at least 2 hours before serving.",
      "url": "https://example.com/recipe#step6",
      "image": "https://example.com/photos/recipe/step6.jpg"
    }
  ]

• HowToSection (only if a recipe has multiple sections): Use to group steps into multiple sections. See HowToSection for an example.
• Single or repeated property of text: A block of text that includes one or more steps. Google treats all steps as being in a single section. Repeated property values are concatenated into a single block of text. Google then attempts to automatically split the single block of text into individual steps. Google tries to find and remove any section names, step numbers, keywords, and anything else that can incorrectly appear in recipe step text. For best results, we recommend you unambiguously specify steps with HowToStep.

  "recipeInstructions": [
    "In large bowl, gently mix filling ingredients; spoon into crust-lined pie
  plate. Top with second crust. Cut slits or shapes in several places in top
  crust. Bake 40 to 45 minutes. The pie is ready when the or until apples are
  tender and the crust is golden brown. Cool on cooling rack at least 2 hours
  before serving."
  ]

Additional guidelines

• Don't include metadata that belongs elsewhere. In particular, use the author property to specify the author, recipeCuisine for cuisine, recipeCategory for category, and keywords for other keywords.
• Include only text on how to make the dish and don't include other text such as "Directions", "Watch the video", "Step 1". Specify those phrases outside of structured data.

  Not recommended:

  "recipeInstructions": [{
    "@type": "HowToStep",
    "text": "Step 1. Heat oven to 425°F."
  }]

  Recommended:

  "recipeInstructions": [{
    "@type": "HowToStep",
    "text": "Heat oven to 425°F."
  }]

Text or Integer

The quantity produced by the recipe, if applicable. Specify the number of servings produced from this recipe with just a number. If you wish to use a different unit (for example, number of items), you may include additional yields. This is required if you specify any nutritional information per serving (such as nutrition.calories).

Example

"recipeYield": [
  "6",
  "24 cookies"
]

Duration

The total time it takes to prepare the cook the dish, in ISO 8601 format, if applicable.

Use totalTime or a combination of both cookTime and prepTime.

A video depicting the steps to make the dish. Follow the list of required and recommended Video properties.

A list of detailed steps for the section, and/or sub-sections. For example, a pizza recipe may have one section of steps for making the crust, one for preparing the toppings, and one for combining and baking.

Example:

{
  "@type": "HowToSection",
  "name": "Assemble the pie",
  "itemListElement": [
    {
      "@type": "HowToStep",
      "text": "In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate."
    }, {
      "@type": "HowToStep",
      "text": "Top with second crust. Cut slits or shapes in several places in top crust."
    }
  ]
}

The name of the section.

A list of detailed substeps, including directions or tips.

Optional if text is used.

The full instruction text of this step.

Optional if itemListElement is used. Additional guidelines:

• Include only instructional text and don't include other text such as "Directions", "Watch the video", "Step 1". Specify those phrases outside of the marked up property.
  

  Not recommended:

  {
    "@type": "HowToStep",
    "text": "Step 1. Heat oven to 425°F."
  }

  Recommended:

  {
    "@type": "HowToStep",
    "text": "Heat oven to 425°F."
  }

An image for the step. Additional image guidelines:

• Image URLs must be crawlable and indexable.
• Images must represent the marked up content.
• Images must be in .jpg, .png, or. gif format.

The word or short phrase summarizing the step (for example, "Arrange pie crust"). Don't use non-descriptive text (for example, "Step 1: [text]") or other form of step number (for example, "1. [text]").

A URL that directly links to the step (if one is available). For example, an anchor link fragment.

A video for this step or a clip of the video.

For VideoObject, follow the list of required and recommended Video or Clip properties.

The text of the direction or tip.

ListItem

Annotation for a single item page.

Integer

Ordinal position of the item page in the list. For example:

"itemListElement": [
  {
    "@type": "ListItem",
    "position": 1,
  }, {
    "@type": "ListItem",
    "position": 2,
  }
]

URL

The canonical URL of the item page. Every item must have a unique URL.