Données structurées des recettes (Recipe, HowTo, ItemList)

Ajoutez des données structurées à vos recettes pour aider les utilisateurs à trouver plus facilement vos créations culinaires sur Google. Lorsque vous spécifiez des détails tels que les avis des contributeurs, les temps de préparation et de cuisson, et les informations nutritionnelles, Google est plus à même de présenter votre recette aux internautes de façon intéressante. Les recettes peuvent apparaître dans les résultats de recherche Google et dans Google Images.

L'illustration représente comment les résultats enrichis sur les recettes peuvent apparaître dans la recherche Google. Elle inclut quatre résultats enrichis issus de différents sites Web, qui intègrent des informations sur le temps de préparation de la recette, une image et des avis. L'illustration représente comment une recette peut apparaître dans Google Images. Six résultats d'images affichent différents aliments, et trois de ces résultats contiennent un badge de recette indiquant à l'utilisateur qu'il s'agit d'une recette.

Selon le balisage de votre contenu, vos recettes peuvent également bénéficier des améliorations suivantes :

Améliorations spécifiques aux recettes
Carrousel hôte de recettes : aidez les utilisateurs à explorer les pages de votre galerie de recettes en ajoutant des données structurées ItemList. L'illustration représente comment un carrousel hôte de recettes peut apparaître dans la recherche Google. Elle montre trois recettes différentes du même site Web sous forme de carrousel que les utilisateurs peuvent explorer pour sélectionner une recette spécifique.

Comment ajouter des données structurées

Ces données structurées représentent un format normalisé permettant de fournir des informations sur une page et de classer son contenu. En savoir plus sur le fonctionnement des données structurées

Voici, dans les grandes lignes, comment créer, tester et publier des données structurées.

  1. Ajoutez les propriétés obligatoires. En fonction du format que vous utilisez, découvrez où insérer des données structurées sur la page.
  2. Suivez les consignes.
  3. Validez votre code à l'aide de l'outil de test des résultats enrichis et corrigez les erreurs critiques, le cas échéant. Envisagez également de résoudre les problèmes non critiques que l'outil a pu signaler, car cela peut contribuer à améliorer la qualité de vos données structurées. Toutefois, ce n'est pas nécessaire pour pouvoir bénéficier des résultats enrichis.
  4. Déployez quelques pages où figurent vos données structurées et utilisez l'outil d'inspection d'URL pour découvrir comment Google voit la page. Assurez-vous que Google peut accéder à votre page et qu'elle n'est pas bloquée par un fichier robots.txt, la balise noindex ni par des identifiants de connexion. Si tout semble être en ordre, vous pouvez demander à Google d'explorer de nouveau vos URL.
  5. Pour informer Google des modifications futures de vos pages, nous vous recommandons de nous envoyer un sitemap. Vous pouvez automatiser cette opération à l'aide de l'API Sitemap de la Search Console.

Exemples

Voici quelques exemples de recettes au format JSON-LD.

Recette dans la recherche Google

Voici un exemple de page pouvant apparaître dans la recherche Google.

<html>
  <head>
    <title>Non-Alcoholic Piña Colada</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Recipe",
      "name": "Non-Alcoholic Piña Colada",
      "image": [
      "https://example.com/photos/1x1/photo.jpg",
      "https://example.com/photos/4x3/photo.jpg",
      "https://example.com/photos/16x9/photo.jpg"
      ],
      "author": {
        "@type": "Person",
        "name": "Mary Stone"
      },
      "datePublished": "2024-03-10",
      "description": "This non-alcoholic pina colada is everyone's favorite!",
      "recipeCuisine": "American",
      "prepTime": "PT1M",
      "cookTime": "PT2M",
      "totalTime": "PT3M",
      "keywords": "non-alcoholic",
      "recipeYield": "4 servings",
      "recipeCategory": "Drink",
      "nutrition": {
        "@type": "NutritionInformation",
        "calories": "120 calories"
      },
      "aggregateRating": {
        "@type": "AggregateRating",
        "ratingValue": 5,
        "ratingCount": 18
      },
      "recipeIngredient": [
        "400ml of pineapple juice",
        "100ml cream of coconut",
        "ice"
      ],
      "recipeInstructions": [
        {
          "@type": "HowToStep",
          "name": "Blend",
          "text": "Blend 400ml of pineapple juice and 100ml cream of coconut until smooth.",
          "url": "https://example.com/non-alcoholic-pina-colada#step1",
          "image": "https://example.com/photos/non-alcoholic-pina-colada/step1.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Fill",
          "text": "Fill a glass with ice.",
          "url": "https://example.com/non-alcoholic-pina-colada#step2",
          "image": "https://example.com/photos/non-alcoholic-pina-colada/step2.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Pour",
          "text": "Pour the pineapple juice and coconut mixture over ice.",
          "url": "https://example.com/non-alcoholic-pina-colada#step3",
          "image": "https://example.com/photos/non-alcoholic-pina-colada/step3.jpg"
        }
      ],
      "video": {
        "@type": "VideoObject",
        "name": "How to Make a Non-Alcoholic Piña Colada",
        "description": "This is how you make a non-alcoholic piña colada.",
        "thumbnailUrl": [
          "https://example.com/photos/1x1/photo.jpg",
          "https://example.com/photos/4x3/photo.jpg",
          "https://example.com/photos/16x9/photo.jpg"
         ],
        "contentUrl": "https://www.example.com/video123.mp4",
        "embedUrl": "https://www.example.com/videoplayer?video=123",
        "uploadDate": "2024-02-05T08:00:00+08:00",
        "duration": "PT1M33S",
        "interactionStatistic": {
          "@type": "InteractionCounter",
          "interactionType": { "@type": "WatchAction" },
          "userInteractionCount": 2347
        },
        "expires": "2024-02-05T08:00:00+08:00"
       }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Voici un exemple de page récapitulant des recettes (page contenant une liste de recettes) avec des données structurées itemList. Ce contenu peut s'afficher sous forme de grille dans les résultats de recherche.

<html>
  <head>
    <title>Grandma's Best Pie Recipes</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "ItemList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "url": "https://example.com/apple-pie.html"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "url": "https://example.com/blueberry-pie.html"
        },
        {
          "@type": "ListItem",
          "position": 3,
          "url": "https://example.com/cherry-pie.html"
        }]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Consignes

Pour que votre balisage puisse s'afficher dans les résultats de recherche, vous devez respecter les consignes générales relatives aux données structurées.

Les consignes suivantes s'appliquent aux données structurées Recipe.

  • Utilisez des données structurées Recipe pour le contenu ayant trait à la préparation d'un plat particulier. Par exemple, "gommage du visage" ou "idées de fête" ne sont pas des noms valables pour un plat.
  • Pour que vos recettes apparaissent dans un carrousel ou dans une grille, vous devez respecter les consignes suivantes :
    • Fournissez des données structurées ItemList pour récapituler les recettes que vous voulez ajouter à la liste. Vous pouvez fournir des données structurées ItemList séparément ou avec des données structurées de recette.
    • Votre site doit contenir une page récapitulative qui répertorie toutes les recettes de la collection. Par exemple, lorsqu'un internaute clique sur le lien de la page récapitulative dans les résultats de recherche, il doit être redirigé vers une page de votre site répertoriant les recettes associées à sa recherche.

Définitions des types de données structurées

Vous devez inclure les propriétés obligatoires pour que votre contenu puisse s'afficher sous forme de résultat enrichi dans la recherche Google. Vous pouvez également inclure les propriétés recommandées pour ajouter d'autres informations à votre contenu et ainsi offrir une meilleure expérience utilisateur.

Recipe

Balisez le contenu de votre recette avec les propriétés suivantes du type schema.org Recipe. La définition complète de Recipe est disponible sur schema.org/Recipe. Les propriétés prises en charge par Google sont les suivantes :

Propriétés obligatoires
image

URL ou ImageObject

Image du plat terminé.

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"
]
name

Text

Nom du plat.
Propriétés recommandées
aggregateRating

AggregateRating

Annotation désignant la note moyenne attribuée à l'élément. Respectez les Consignes relatives aux extraits d'avis ainsi que la liste des propriétésAggregateRating obligatoires et recommandées.

Si les données structurées Recipe contiennent un seul avis, le nom de son auteur doit correspondre à une personne, ou à une organisation ou entreprise valide. Par exemple "50 % de remise sur les ingrédients" n'est pas un nom valide.
author

Person ou Organization

Nom de la personne ou de l'organisation qui a rédigé la recette. Pour aider Google à interpréter les auteurs dans différentes fonctionnalités, envisagez de suivre les bonnes pratiques en matière de balisage des auteurs.
cookTime

Duration

Temps de cuisson du plat, au format ISO 8601, le cas échéant.

Utilisez toujours cette propriété conjointement avec prepTime.

datePublished

Date

Date à laquelle la recette a été publiée, au format ISO 8601, le cas échéant.
description

Text

Brève description du plat.
keywords

Text

Autres termes liés à la recette tels que la saison ("été"), l'occasion spéciale ("Halloween") ou d'autres descripteurs ("rapide", "facile", "authentique").

Consignes supplémentaires

  • Séparez plusieurs entrées d'une liste de mots clés par des virgules.
  • N'utilisez pas de balise correspondant à recipeCategory ou recipeCuisine.

    Approche déconseillée :

    "keywords": "dessert, American"

    Approche conseillée :

    "keywords": "winter apple pie, nutmeg crust"
nutrition.calories

Energy

Nombre de calories de chaque portion pour cette recette. Si nutrition.calories est spécifié, recipeYield doit être défini avec le nombre de portions.
prepTime

Duration

Temps de préparation des ingrédients et de l'espace de travail pour le plat, au format ISO 8601, le cas échéant.

Utilisez toujours cette propriété conjointement avec cookTime.
recipeCategory

Text

Type de repas ou de plat dont la recette fait l'objet. Exemple : "dîner", "plat principal" ou "dessert, collation".
recipeCuisine

Text

Région associée à la recette. Par exemple, "France", "Méditerranée" ou 'États-Unis".
recipeIngredient

Text

Un des ingrédients utilisés dans la recette.

Exemple :

"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"
]

Consignes supplémentaires :

  • Incluez uniquement le texte de l'ingrédient nécessaire à la préparation de la recette.
  • N'incluez pas d'informations inutiles, telles que la définition de l'ingrédient.
recipeInstructions

HowToStep, HowToSection ou Text

Étapes de préparation du plat.

Plusieurs options permettent de définir la valeur de recipeInstructions. Pour des raisons de clarté, nous recommandons l'utilisation de HowToStep. HowToSection peut également être utilisé pour regrouper des propriétés HowToStep lorsque la recette comporte plusieurs sections.

  • HowToStep : spécifiez les étapes de cette recette avec 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 (uniquement si une recette se fait en plusieurs parties) : permet de regrouper les étapes en plusieurs sections. Pour consulter un exemple, voir HowToSection.
  • Propriété de texte unique ou répétée : bloc de texte comprenant une ou plusieurs étapes. Google traite toutes les étapes dans une seule section. Les valeurs de propriétés répétées sont concaténées dans un seul bloc de texte. Google tente ensuite de scinder automatiquement le bloc de texte en étapes individuelles. Google tente de rechercher et de supprimer les noms de section, les numéros d'étape, les mots clés et tout élément susceptible d'apparaître de manière incorrecte dans le texte des étapes de la recette. Pour de meilleurs résultats, nous vous recommandons de spécifier les étapes avec 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."
]

Consignes supplémentaires

  • N'incluez pas de métadonnées qui ne sont pas pertinentes. En particulier, utilisez la propriété author pour spécifier l'auteur, recipeCuisine pour la cuisine, recipeCategory pour la catégorie et keywords pour les autres mots clés.
  • N'incluez que le texte décrivant comment préparer le plat, pas de texte tel que "Instructions", "Regarder la vidéo", "Étape 1". Indiquez ces expressions en dehors des données structurées.

    Approche déconseillée :

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

    Approche conseillée :

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

Text ou Integer

Quantité produite par la recette, le cas échéant. Indiquez le nombre de portions que cette recette permet de préparer. Si vous souhaitez utiliser une autre unité (par exemple, le nombre d'éléments), vous pouvez inclure des champs supplémentaires. Cela est obligatoire si vous spécifiez des informations nutritionnelles par portion (par exemple, nutrition.calories).

Exemple

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

Duration

Temps total de préparation du plat, au format ISO 8601, le cas échéant.

Utilisez totalTime ou une combinaison de cookTime et prepTime.

video VideoObject

Vidéo illustrant les étapes de préparation du plat. Respectez la liste des propriétés vidéo obligatoires et recommandées.

HowToSection

Utilisez HowToSection pour regrouper une séquence d'étapes (ou de sous-sections) qui font partie des instructions d'une recette. Spécifiez HowToSection directement dans la définition de la propriété recipeInstructions ou comme itemListElement d'une autre propriété HowToSection.

Le type HowToSection définit une section d'une recette unique et contient une ou plusieurs étapes. N'utilisez pas HowToSection pour définir différentes recettes pour un même plat. HowToSection est destiné à une seule et même recette. Si vous souhaitez répertorier plusieurs recettes pour un même plat, utilisez plusieurs objets Recipe. Par exemple, pour spécifier plusieurs façons de préparer une tarte aux pommes, répertoriez-les comme plusieurs objets Recipe, et non comme des objets HowToSection.

La définition complète de la propriété HowToSection est disponible sur schema.org/HowToSection.

Propriétés obligatoires
itemListElement HowToStep

Liste des étapes détaillées de la section et/ou des sous-sections. Par exemple, une recette de pizza peut comporter un ensemble d'étapes pour la préparation de la pâte, un autre pour la préparation de la garniture, puis un autre pour expliquer comment cuire la pâte et la garniture ensemble.

Exemple :

{
  "@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."
    }
  ]
}
name Text

Nom de la section.

HowToStep

Utilisez HowToStep pour regrouper une ou plusieurs phrases expliquant comment réaliser une partie de la recette, si cela est pertinent pour votre contenu. Spécifiez la propriété text avec les phrases ou, alternativement, définissez itemListElement avec un élément HowToDirection ou HowToTip pour chaque phrase.

Vous pouvez baliser les étapes de la recette avec les propriétés suivantes de type HowToStep. Spécifiez un élément HowToStep directement dans la définition de la propriété recipeInstructions ou comme élément itemListElement d'une propriété HowToSection.

La définition complète de la propriété HowToStep est disponible sur schema.org/HowToStep.

Propriétés obligatoires
itemListElement HowToDirection ou HowToTip

Liste d'étapes secondaires détaillées comprenant des instructions ou des conseils.

Propriété facultative si l'élément text est utilisé.
text Text

Instructions écrites complètes de cette étape.

Propriété facultative si l'élément itemListElement est utilisé. Consignes supplémentaires :

  • N'incluez que le texte décrivant comment préparer la recette, pas le texte tel que "Instructions", "Regarder la vidéo", "Étape 1". Spécifiez ces expressions en dehors de la propriété balisée.

    Approche déconseillée :

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

    Approche conseillée :

    {
  "@type": "HowToStep",
  "text": "Heat oven to 425°F."
}
Propriétés recommandées
image ImageObject ou URL

Image représentant l'étape. Consignes supplémentaires relatives aux images :

  • Les URL des images doivent être explorables et indexables.
  • Les images doivent représenter le contenu balisé.
  • Les images doivent être au format .jpg, .png ou .gif.
name Text

Mot ou courte expression résumant l'étape (par exemple, "Disposer la pâte à tarte"). N'utilisez pas de texte non descriptif (par exemple, "Étape 1 : [texte]") ni d'autre forme de numérotation d'étape (par exemple, "1. [texte]").

url URL

URL qui renvoie directement à l'étape (le cas échéant). Il peut, par exemple, s'agir du fragment d'un lien d'ancrage.

video VideoObject ou Clip

Vidéo représentant cette étape ou clip de la vidéo.

Pour VideoObject, suivez la liste des propriétés de vidéo ou d'extrait vidéo obligatoires et recommandées.

HowToDirection et HowToTip

Utilisez HowToDirection et HowToTip pour décrire des instructions ou des conseils, le cas échéant. Leurs propriétés obligatoires et facultatives sont identiques.

Les définitions complètes des éléments HowToDirection et HowToTip sont disponibles sur schema.org/HowToDirection et schema.org/HowToTip.

Propriétés obligatoires
text Text

Texte de l'instruction ou du conseil.

ItemList

Outre les propriétés de recette, ajoutez les propriétés suivantes pour les listes spécifiques à l'hôte. Bien que ItemList ne soit pas obligatoire, vous devez ajouter les propriétés suivantes si vous souhaitez que votre recette puisse s'afficher dans un carrousel hôte. Pour plus d'informations sur le carrousel hôte, consultez la section Carrousel.

La définition complète de l'élément ItemList est disponible sur schema.org/ItemList.

Propriétés obligatoires
itemListElement

ListItem

Annotation pour une page d'élément.
ListItem.position

Integer

Position ordinale de la page d'élément dans la liste. Exemple :

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

URL

URL canonique de la page d'élément. Chaque élément doit avoir une URL unique.

Monitor rich results with Search Console

Search Console is a tool that helps you monitor how your pages perform in Google Search. You don't have to sign up for Search Console to be included in Google Search results, but it can help you understand and improve how Google sees your site. We recommend checking Search Console in the following cases:

  1. After deploying structured data for the first time
  2. After releasing new templates or updating your code
  3. Analyzing traffic periodically

After deploying structured data for the first time

After Google has indexed your pages, look for issues using the relevant Rich result status report. Ideally, there will be an increase of valid items, and no increase in invalid items. If you find issues in your structured data:

  1. Fix the invalid items.
  2. Inspect a live URL to check if the issue persists.
  3. Request validation using the status report.

After releasing new templates or updating your code

When you make significant changes to your website, monitor for increases in structured data invalid items.
  • If you see an increase in invalid items, perhaps you rolled out a new template that doesn't work, or your site interacts with the existing template in a new and bad way.
  • If you see a decrease in valid items (not matched by an increase in invalid items), perhaps you are no longer embedding structured data in your pages. Use the URL Inspection tool to learn what is causing the issue.

Analyzing traffic periodically

Analyze your Google Search traffic using the Performance Report. The data will show you how often your page appears as a rich result in Search, how often users click on it and what is the average position you appear on search results. You can also automatically pull these results with the Search Console API.

Dépannage

Si vous ne parvenez pas à mettre en œuvre ou à déboguer des données structurées, voici quelques ressources susceptibles de vous aider.