Dados estruturados de receita (Recipe
, HowTo
, ItemList
)
Use dados estruturados para informar o Google sobre suas receitas e ajudar os usuários a encontrar esse conteúdo. Quando você fornece informações como avaliações, tempo de preparo e informações nutricionais, o Google entende melhor a receita e a apresenta aos usuários de uma maneira mais interessante. As receitas aparecem nos resultados da pesquisa do Google e no Imagens do Google.


Com base na marcação do conteúdo, suas receitas podem se qualificar para as seguintes melhorias:
Melhorias de receitas | |
---|---|
Receitas guiadas: ative o Google Assistente para orientar os usuários pelas receitas no Google
Home e nos smart displays. Para isso, adicione dados estruturados Recipe .
Existem algumas propriedades adicionais que são obrigatórias para "Receitas guiadas", mas somente
recomendadas para a Pesquisa Google. Adicione recipeIngredient e
recipeInstructions . Se você adicionar a propriedade video , também precisará incluir contentUrl .
Para mais informações sobre receitas no Google Assistente, saiba como criar Ações com conteúdo da Web. |
![]() |
Carrossel de host de receitas: adicione dados estruturados ItemList para que os usuários explorem sua galeria de receitas. |
![]() |
Como adicionar dados estruturados
Os dados estruturados são um formato padronizado para fornecer informações sobre uma página e classificar o conteúdo dela. Caso você não saiba muito sobre o assunto, veja como os dados estruturados funcionam.
Esta é uma visão geral de como criar, testar e lançar dados estruturados. Para ver um guia passo a passo sobre como adicioná-los a uma página da Web, confira nosso codelab.
- Adicione as propriedades obrigatórias. Com base no formato que você está usando, saiba onde inserir dados estruturados na página.
- Siga as diretrizes.
- Valide o código com o Teste de pesquisa aprimorada e corrija os erros críticos. Corrija também os problemas não críticos que possam ser sinalizados na ferramenta, porque eles podem melhorar a qualidade dos dados estruturados, mas isso não é necessário para se qualificar para pesquisas aprimoradas.
- Implante algumas páginas que incluam os dados estruturados e use a Ferramenta de inspeção de URL para testar como o Google vê a página. Verifique se a página está
acessível ao Google e se não está bloqueada por um arquivo robots.txt, pela tag
noindex
ou por requisitos de login. Se estiver tudo certo, peça ao Google para rastrear novamente seus URLs. - Para informar o Google sobre mudanças futuras, recomendamos que você envie um sitemap. É possível automatizar isso com a API Search Console Sitemap.
Exemplos
Veja alguns exemplos de receitas que usam código JSON-LD.
Receitas guiadas
Veja um exemplo de página qualificada para exibição na Pesquisa Google e como uma "Receita guiada" no Assistente.
<html> <head> <title>Party Coffee Cake</title> <script type="application/ld+json"> { "@context": "https://schema.org/", "@type": "Recipe", "name": "Party Coffee Cake", "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": "2018-03-10", "description": "This coffee cake is awesome and perfect for parties.", "prepTime": "PT20M", "cookTime": "PT30M", "totalTime": "PT50M", "keywords": "cake for a party, coffee", "recipeYield": "10", "recipeCategory": "Dessert", "recipeCuisine": "American", "nutrition": { "@type": "NutritionInformation", "calories": "270 calories" }, "recipeIngredient": [ "2 cups of flour", "3/4 cup white sugar", "2 teaspoons baking powder", "1/2 teaspoon salt", "1/2 cup butter", "2 eggs", "3/4 cup milk" ], "recipeInstructions": [ { "@type": "HowToStep", "name": "Preheat", "text": "Preheat the oven to 350 degrees F. Grease and flour a 9x9 inch pan.", "url": "https://example.com/party-coffee-cake#step1", "image": "https://example.com/photos/party-coffee-cake/step1.jpg" }, { "@type": "HowToStep", "name": "Mix dry ingredients", "text": "In a large bowl, combine flour, sugar, baking powder, and salt.", "url": "https://example.com/party-coffee-cake#step2", "image": "https://example.com/photos/party-coffee-cake/step2.jpg" }, { "@type": "HowToStep", "name": "Add wet ingredients", "text": "Mix in the butter, eggs, and milk.", "url": "https://example.com/party-coffee-cake#step3", "image": "https://example.com/photos/party-coffee-cake/step3.jpg" }, { "@type": "HowToStep", "name": "Spread into pan", "text": "Spread into the prepared pan.", "url": "https://example.com/party-coffee-cake#step4", "image": "https://example.com/photos/party-coffee-cake/step4.jpg" }, { "@type": "HowToStep", "name": "Bake", "text": "Bake for 30 to 35 minutes, or until firm.", "url": "https://example.com/party-coffee-cake#step5", "image": "https://example.com/photos/party-coffee-cake/step5.jpg" }, { "@type": "HowToStep", "name": "Enjoy", "text": "Allow to cool and enjoy.", "url": "https://example.com/party-coffee-cake#step6", "image": "https://example.com/photos/party-coffee-cake/step6.jpg" } ], "aggregateRating": { "@type": "AggregateRating", "ratingValue": "5", "ratingCount": "18" }, "video": { "@type": "VideoObject", "name": "How to make a Party Coffee Cake", "description": "This is how you make a 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": "https://www.example.com/video123.mp4", "embedUrl": "https://www.example.com/videoplayer?video=123", "uploadDate": "2018-02-05T08:00:00+08:00", "duration": "PT1M33S", "interactionStatistic": { "@type": "InteractionCounter", "interactionType": { "@type": "WatchAction" }, "userInteractionCount": 2347 }, "expires": "2019-02-05T08:00:00+08:00" } } </script> </head> <body> </body> </html>
Receita na Pesquisa
Veja um exemplo de página qualificada para ser exibida na Pesquisa.
<html> <head> <title>Non-alcoholic Pina Colada</title> <script type="application/ld+json"> { "@context": "https://schema.org/", "@type": "Recipe", "name": "Non-alcoholic Pina 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": "2018-03-10", "description": "This non-alcoholic pina colada is everyone's favorite!", "recipeCuisine": "American", "prepTime": "PT1M", "cookTime": "PT2M", "totalTime": "PT3M", "keywords": "non-alcoholic", "recipeYield": "1 serving", "recipeCategory": "Drink", "nutrition": { "@type": "NutritionInformation", "calories": "120 calories" }, "aggregateRating": { "@type": "AggregateRating", "ratingValue": "5", "ratingCount": "18" }, "recipeIngredient": [ "2 cups of pineapple juice", "5/8 cup cream of coconut", "ice" ], "recipeInstructions": [ { "@type": "HowToStep", "text": "Blend 2 cups of pineapple juice and 5/8 cup cream of coconut until smooth." }, { "@type": "HowToStep", "text": "Fill a glass with ice." }, { "@type": "HowToStep", "text": "Pour the pineapple juice and coconut mixture over ice." } ], "video": { "@type": "VideoObject", "name": "How to make a Party Coffee Cake", "description": "This is how you make a 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": "https://www.example.com/video123.mp4", "embedUrl": "https://www.example.com/videoplayer?video=123", "uploadDate": "2018-02-05T08:00:00+08:00", "duration": "PT1M33S", "interactionStatistic": { "@type": "InteractionCounter", "interactionType": { "@type": "WatchAction" }, "userInteractionCount": 2347 }, "expires": "2019-02-05T08:00:00+08:00" } } </script> </head> <body> </body> </html>
Carrossel
Veja um exemplo de página de resumo de receitas (uma página com uma lista de receitas) com dados estruturados de itemList
. Esse conteúdo pode ser exibido em uma grade nos resultados da Pesquisa.
<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>
Diretrizes
É preciso seguir as diretrizes gerais de dados estruturados para que sua receita possa ser exibida nos resultados da Pesquisa. Se você quiser que a receita seja exibida como uma "Receita guiada" no Assistente, verifique se o conteúdo segue a política de restrições de conteúdo do Assistente.
As diretrizes a seguir se aplicam aos dados estruturados Recipe
.
- Use dados estruturados
Recipe
em conteúdos sobre como preparar determinado prato. Por exemplo, "esfoliante facial" ou "ideias para festas" não são nomes válidos para um prato. - Para que as receitas apareçam em um carrossel ou em uma grade, siga estas diretrizes:
- Forneça dados estruturados de
ItemList
para resumir as receitas na sua lista. É possível fornecer dados estruturados deItemList
separadamente ou em conjunto com os dados estruturados de receita. - Seu site precisa ter uma página de resumo que liste todas as receitas da coleção. Por exemplo, quando um usuário clicar no link de resumo dos resultados da Pesquisa, será direcionado corretamente para uma página no seu site que lista as receitas relacionadas à pesquisa.
- Forneça dados estruturados de
Definições de tipos de dados estruturados
É necessário incluir as propriedades obrigatórias para que seu conteúdo seja qualificado para exibição como uma pesquisa aprimorada. Também é possível incluir as propriedades recomendadas para dar mais informações sobre o conteúdo, o que pode proporcionar uma melhor experiência do usuário.
Recipe
Marque o conteúdo da receita com as seguintes propriedades do tipo Recipe
do schema.org. A definição completa de Recipe
está disponível em schema.org/Recipe.
Veja as propriedades aceitas pelo Google:
Propriedades obrigatórias | |
---|---|
image
|
É a imagem do prato pronto. Outras diretrizes para imagens:
Exemplo: "image": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ] |
name |
É o nome do prato. |
Propriedades recomendadas | |
---|---|
aggregateRating |
É a nota da avaliação média atribuída ao item. Siga as diretrizes de snippet de avaliação e a lista de propriedades Se os dados estruturados |
author |
É o nome da pessoa ou organização que escreveu a receita. Para ajudar o Google a entender melhor a autoria dos vários recursos, siga as práticas recomendadas de marcação de autores. |
cookTime |
É o tempo que leva para cozinhar o prato, no formato ISO 8601. Use sempre em combinação com |
datePublished |
É a data em que a receita foi publicada, no formato ISO 8601. |
description |
É um pequeno resumo descrevendo o prato. |
keywords
|
São outros termos para a receita, como uma estação do ano ("verão"), uma data comemorativa ("Natal") ou outros descritores ("rápido", "fácil", "autêntico"). Diretrizes adicionais
|
nutrition.calories |
É a quantidade de calorias em cada porção desta receita. Se |
prepTime |
É o tempo que leva para preparar os ingredientes e o espaço de trabalho do prato, no formato ISO 8601. Use sempre em combinação com |
recipeCategory |
É o tipo de refeição ou prato da receita. Por exemplo: "jantar", "prato principal" ou "sobremesa, lanche". |
recipeCuisine |
É a região associada à receita. Por exemplo, "francesa", "mediterrânea" ou "americana". |
recipeIngredient |
É um ingrediente usado na receita. Exemplo: "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" ] Diretrizes adicionais:
|
recipeInstructions
|
São as etapas para preparar o prato. Existem várias opções para definir o valor de
Diretrizes adicionais
|
recipeYield |
É a quantidade produzida pela receita. Especifique o número de porções
produzidas a partir dessa receita com apenas um número. Se você quiser usar uma unidade diferente (por
exemplo, o número de itens), inclua rendimentos adicionais. Isso é necessário se você
especificar qualquer informação alimentar por porção (como Exemplo "recipeYield": [ "6", "24 cookies" ] |
totalTime |
É o tempo total necessário para preparar e cozinhar o prato, no formato ISO 8601. Use |
video
|
VideoObject
É um vídeo que demonstra as etapas de preparação do prato. Siga a lista de propriedades de vídeo obrigatórias e recomendadas.
|
video.contentUrl
|
É um URL que leva ao próprio arquivo de mídia do vídeo, em um dos formatos de codificação compatíveis. Não crie um link para a página em que o vídeo está localizado. Ele precisa ser o URL do próprio arquivo de mídia de vídeo. "contentUrl": "https://www.example.com/video/123/file.mp4" Siga nossas práticas recomendadas de vídeo. |
video.hasPart
|
É um clipe que faz parte de todo o vídeo. |
video.hasPart.endOffset
|
É o horário de término do clipe exibido como o número em segundos em relação ao início do vídeo. |
video.hasPart.name
|
É o nome do clipe. Por exemplo, "sovar a massa" pode ser o nome do clipe que mostra como sovar a massa do pão. |
video.hasPart.startOffset
|
É o momento de início do clipe exibido como o número em segundos em relação ao início do vídeo. |
video.hasPart.url
|
É um link para o início do clipe. O início do clipe precisa corresponder ao valor configurado em
"startOffset": 20, "endOffset": 29, "url": "https://www.example.com/example?t=20" |
HowToSection
Use HowToSection
para agrupar uma sequência de etapas (ou subseções) que compõem
parte das instruções de uma receita. Especifique HowToSection
diretamente na
definição da propriedade recipeInstructions
ou como itemListElement
de outro
HowToSection
.
O tipo HowToSection
define uma seção de uma única receita e
contém uma ou várias etapas. Não use HowToSection
para definir receitas
diferentes para o mesmo prato. Em vez disso, use HowToSection
como parte de uma única receita. Para listar
diversas receitas de um mesmo prato, use vários objetos Recipe
. Por exemplo, para
várias maneiras de fazer uma torta de maçã, liste-as como vários objetos Recipe
, e não
HowToSection
.
A definição completa de HowToSection
está disponível em schema.org/HowToSection (em inglês).
Propriedades obrigatórias | |
---|---|
itemListElement
|
HowToStep
É uma lista de etapas detalhadas para a seção e/ou as subseções. Por exemplo, uma receita de pizza pode ter
uma seção de etapas para fazer a massa, uma para preparar o
recheio e outra para montar e assar. Se uma receita tiver seções
não definidas com Exemplo: { "@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
É o nome da seção. |
HowToStep
Use HowToStep
para agrupar uma ou mais frases que expliquem como fazer parte da receita. Defina a propriedade text
com as
frases ou, alternativamente, defina itemListElement
com
HowToDirection
ou HowToTip
para cada uma delas.
Marque as etapas da receita com as seguintes propriedades
do tipo HowToStep. Especifique
HowToStep
diretamente na definição da propriedade recipeInstructions
ou como itemListElement
de HowToSection
.
A definição completa de HowToStep
está disponível em
schema.org/HowToStep (em inglês).
Propriedades obrigatórias | |
---|---|
itemListElement
|
HowToDirection ou HowToTip
É uma lista de subetapas detalhadas, incluindo orientações ou dicas. Essa propriedade é opcional quando |
text
|
Text
É o texto de instruções completo desta etapa. Essa propriedade é opcional quando
|
Propriedades recomendadas | |
---|---|
image
|
ImageObject ou URL
É a imagem da etapa. Outras diretrizes para imagens:
|
name
|
Text
É uma palavra ou frase curta que resume a etapa (por exemplo, "sovar a massa"). Evite usar texto não descritivo (por exemplo, "Etapa 1: [texto]") ou outra forma de numeração (por exemplo, "1. [texto]"). |
url
|
URL
É o |
video
|
VideoObject ou Clip
É um vídeo da etapa ou um clipe do vídeo. Para |
HowToDirection
e HowToTip
Use HowToDirection
e HowToTip
para descrever orientações ou dicas.
Eles têm as mesmas propriedades obrigatórias e recomendadas.
As definições completas de HowToDirection
e HowToTip
estão disponíveis em
schema.org/HowToDirection e
schema.org/HowToTip (páginas em inglês).
Propriedades obrigatórias | |
---|---|
text
|
Text
É o texto da orientação ou dica. |
ItemList
Além das propriedades de receita, adicione as propriedades a seguir para
listas específicas de host. Ainda que ItemList
não seja obrigatória,
é necessário adicionar as seguintes propriedades se quiser que sua receita seja qualificada para um
carrossel de host. Para mais informações sobre o carrossel do host, consulte
Carrossel.
A definição completa de ItemList
está disponível em schema.org/ItemList (em inglês).
Propriedades obrigatórias | |
---|---|
itemListElement
|
É a anotação para uma única página de itens. |
ListItem.position
|
É a posição ordinal da página de itens na lista. Exemplo: "itemListElement": [ { "@type": "ListItem", "position": 1, }, { "@type": "ListItem", "position": 2, } ] |
ListItem.url
|
É o URL canônico da página de itens. Cada item precisa ter um URL exclusivo. |
Monitorar pesquisas aprimoradas com o Search Console
O Search Console é uma ferramenta que ajuda você a monitorar o desempenho das suas páginas na Pesquisa Google. Não é preciso se inscrever na plataforma para ser incluído nos resultados da Pesquisa Google, mas isso pode ajudar você a entender e melhorar como vemos seu site. Recomendamos verificar o Search Console nos seguintes casos:
- Depois de implantar os dados estruturados pela primeira vez
- Depois de lançar novos modelos ou atualizar o código
- Análise periódica do tráfego
Depois de implantar os dados estruturados pela primeira vez
Depois que o Google indexar as páginas, procure problemas com o relatório de status da pesquisa aprimorada relevante. Em condições ideais, vai haver um aumento de itens válidos e nenhum aumento de itens inválidos. Se você encontrar problemas nos dados estruturados, faça o seguinte:
- Corrija os itens inválidos.
- Inspecione um URL ativo para verificar se o problema persiste.
- Solicite a validação com o relatório de status.
Depois de lançar novos modelos ou atualizar o código
Ao fazer mudanças significativas no site, monitore aumentos nos itens inválidos de dados estruturados.- Caso você perceba um aumento nos itens inválidos, talvez tenha lançado um novo modelo que não funcione ou o site esteja interagindo com o modelo existente de uma maneira nova e incorreta.
- Caso você veja uma diminuição nos itens válidos (não correspondidos por um aumento nos itens inválidos), talvez não esteja mais incorporando os dados estruturados às páginas. Use a Ferramenta de inspeção de URL para saber o que está causando o problema.
Análise periódica do tráfego
Analise o tráfego da Pesquisa Google com o Relatório de desempenho. Os dados vão mostrar com que frequência sua página aparece como aprimorada na Pesquisa, com que frequência os usuários clicam nela e qual é a posição média dela nos resultados. Também é possível extrair automaticamente esses resultados com a API Search Console.Solução de problemas
Se você tiver problemas para implementar ou depurar dados estruturados, veja alguns recursos que podem ajudar.
- Se você usa um sistema de gerenciamento de conteúdo (CMS) ou se alguém está cuidando do seu site, peça ajuda para o prestador de serviço. Não se esqueça de encaminhar todas as mensagens do Search Console com os detalhes do problema.
- O Google não garante que os recursos que consomem dados estruturados vão ser exibidos nos resultados da pesquisa. Para ver uma lista de motivos comuns por que o Google pode não exibir seu conteúdo na pesquisa aprimorada, consulte as diretrizes gerais de dados estruturados.
- Pode haver um erro nos dados estruturados. Consulte a lista de erros de dados estruturados.
- Se você recebeu uma ação manual de dados estruturados relacionada à sua página, esses dados serão ignorados, embora a página ainda possa aparecer nos resultados da Pesquisa Google. Para corrigir problemas de dados estruturados, use o Relatório de ações manuais.
- Consulte as diretrizes novamente para identificar se o conteúdo não está em conformidade com elas. O problema pode ser causado por conteúdo com spam ou uso de marcação com spam. No entanto, talvez o problema não seja de sintaxe e, por isso, o teste de pesquisa aprimorada não poderá identificá-lo.
- Solução de problemas relacionados à ausência e à queda no total de pesquisas aprimoradas
- Aguarde algum tempo antes de voltar a rastrear e reindexar. Pode levar vários dias depois da publicação de uma página para que o Google a localize e rastreie. Para perguntas gerais sobre rastreamento e indexação, consulte as Perguntas frequentes sobre rastreamento e indexação da Pesquisa Google.
- Poste uma pergunta no fórum da Central da Pesquisa Google