Gerador de schema de receita

Como gerar o schema de receita

Recipe tem mais propriedades que dependem umas das outras do que qualquer outro tipo comum. O gerador escreve a marcação e o cartão a partir dos mesmos valores e aponta cada contradição que consegue ver.

1. Dê nome ao prato e adicione a foto. Os dois são obrigatórios. A foto é do prato pronto, numa URL rastreável — o Google sugere a mesma foto em várias proporções.
2. Informe os tempos na dupla certa. Ou um tempo total, ou preparo e cozimento juntos. Escreva como pensa neles — 40 minutos, 1h30, 1,5 h —; a saída é ISO 8601 de qualquer jeito.
3. Amarre as calorias ao número de porções. Caloria é por porção, então caloria sem porção está incompleta. O gerador trata isso como erro, porque o Google declara a exigência numa frase só.
4. Escreva ingredientes e modo de preparo em linhas. Um ingrediente por linha, com a medida em g ou ml ao lado da xícara e da colher; um passo por linha, sem "Passo 1". Cada passo vira um HowToStep.
5. Cole as duas saídas. O JSON-LD vai na página da receita. O cartão traz os mesmos ingredientes e os mesmos passos — aqui isso importa mais do que em qualquer outro tipo, porque são esses textos que o Google mostra.

Os três tempos e as duplas que valem

Um gerador de schema de receita transforma uma receita em JSON-LD Recipe — os dados estruturados que o Google lê para ingredientes, modo de preparo, tempos e informação nutricional. Só duas propriedades são obrigatórias, name e image. O que interessa acontece entre as opcionais, porque várias só valem acompanhadas.

Na documentação em português, cookTime diz use sempre em combinação com prepTime; prepTime diz use sempre em combinação com cookTime; e totalTime, use totalTime ou uma combinação de cookTime e prepTime. Sobram duas formas válidas:

A quarta linha não é hipotética. Em 26 de setembro de 2026 abrimos o JSON-LD de três receitas do TudoGostoso — bolo de fubá cremoso, bolo de chocolate e mousse de maracujá —, e as três marcam prepTime e totalTime com o mesmo valor e nenhum cookTime. Neste gerador, isso é erro.

Os três tempos usam duração ISO 8601 — PT1H30M, não "uma hora e meia". O formulário aceita o que você tem na cabeça — 40 minutos, 1 hora e 30 minutos, 1h30, 1,5 h, 1:30, 90 ou a forma ISO — e entrega a ISO. Só um 1,5 sem unidade ele recusa, em vez de adivinhar se é minuto e meio ou hora e meia. E uma coisa que não é regra do Google: totalTime não precisa ser a soma dos outros dois. Descanso da massa, geladeira e fermentação são tempo de verdade. O gerador só avisa quando o total é menor que a soma, porque aí a conta não fecha.

Xícara de 200 ou de 240 ml? O ingrediente é o texto que aparece

recipeIngredient é texto: o que você escreve é o que o Google lê e pode mostrar. E a medida caseira brasileira não tem um tamanho só. Para o rótulo de alimentos, a Anvisa fixa as capacidades no Anexo VII da IN 75/2020; a tabela de conversão da Receitas Nestlé usa outros números:

A própria Nestlé avisa que uma xícara de chá pode ter entre 200 e 250 ml, e uma colher de sopa entre 10 e 15 ml, dependendo do modelo. Numa xícara, a diferença é de 20%; num bolo, é massa que não dá certo. Por isso: 1 xícara (chá) de leite (240 ml), 500 g de polvilho azedo. O Google pede só o texto necessário para fazer a receita, e a medida em ml ou g é exatamente isso — ao contrário de explicar o que é polvilho ou onde comprar o queijo, que é conteúdo da página, não ingrediente. No mesmo TudoGostoso, o bolo de fubá pede "4 xícaras de leite" e "2 colheres de farinha de trigo", sem dizer se de chá ou de sopa.

Calorias e porções são um fato só

A regra do Google cabe numa linha: se nutrition.calories estiver definido, recipeYield precisa ser definido com o número de porções. E recipeYield quer o número de porções com apenas um número; outras unidades entram como rendimentos adicionais. Caloria sem porção não informa nada — 360 kcal é um lanche ou a fornada inteira, dependendo de um número que falta. Por isso o gerador trata a porção ausente como erro, não como aviso.

"recipeYield": "10"
      "nutrition": { "@type": "NutritionInformation", "calories": "360 kcal" }

O schema.org define energia como número seguido da unidade, então 360 kcal — a unidade dos rótulos brasileiros — cabe no formato; os exemplos do Google usam calories como unidade. O que não serve é caloria sem número.

A mesma disciplina vale para keywords: são termos extras — uma estação, uma data como Natal, descritores como "rápido" ou "fácil", nos exemplos da própria página em português —, não repetição do que outras propriedades já dizem. O Google pede para não usar como palavra-chave o que na verdade é recipeCategory ou recipeCuisine: "Lanche" é categoria, "Mineira" é culinária, e nenhuma das duas vai de novo nas keywords. O gerador avisa quando uma palavra-chave repete uma delas.

Modo de preparo em HowToStep — sem "Passo 1"

Há três jeitos de preencher recipeInstructions, e eles não são iguais. Um bloco único de texto obriga o Google a dividir as etapas sozinho, tentando achar e remover nomes de seção e números de passo; ele recomenda HowToStep para especificar as etapas sem ambiguidade, e HowToSection para agrupá-las quando a receita tem partes de verdade — massa, recheio, cobertura.

O gerador escreve um HowToStep por linha e cuida da instrução que vem junto: inclua somente texto sobre como fazer o prato, e não outros trechos, como "Instruções", "Assista ao vídeo", "Etapa 1". Na receita brasileira, os equivalentes de sempre são "Modo de preparo", "Passo 1" e "Assista ao vídeo" — fora do texto do passo, porque a numeração é da marcação, não da frase. O gerador avisa quando um passo começa com "Passo 1" ou "Modo de preparo" (e com os rótulos em inglês, como Step 1); "Etapa 1", "Instruções" e "Assista ao vídeo" — justamente os exemplos da página do Google em português — ele ainda não reconhece, então esses confira você.

Ingredientes e passos viram o cartão visível e a marcação a partir da mesma lista, então o que o leitor vê e o que o Google lê são as mesmas palavras — a mesma regra do gerador de schema FAQ. Na receita, isso pesa mais do que em qualquer outro tipo, porque são justamente esses textos que aparecem no resultado.

Nota e vídeo, as duas propriedades que a receita pede depois

Nota. aggregateRating é recomendada na Recipe e segue as diretrizes de snippet de avaliação inteiras: pelo menos ratingCount ou reviewCount, nada de média copiada de outro site, nada de avaliação incentivada sem aviso. Há ainda uma linha própria da receita: com uma avaliação só, o avaliador precisa ser uma pessoa ou organização válida — "50% de desconto e ingredientes", diz o exemplo em português, não é. O gerador de schema de avaliação confere tudo isso.

Vídeo. video recebe um VideoObject completo, com as mesmas obrigatórias de qualquer vídeo: título único, miniatura numa URL estável e data de publicação, de preferência com fuso — no Brasil, −03:00 para o horário de Brasília. O erro mais comum é o contentUrl apontando para a página da receita em vez do arquivo; o gerador de schema de vídeo recusa esse caso.