Builder Rich Snippet HowTo

Você escreveu um passo a passo e quer descrever para máquinas o que é o título do tutorial e o que é cada instrução. O tipo HowTo do schema.org resolve isso, mas a estrutura aninhada — objeto raiz, array de passos, cada passo com seu próprio tipo — é fácil de digitar torto, e um colchete no lugar errado invalida o bloco inteiro.

São dois campos: título do tutorial e texto de um passo. A saída é um objeto HowTo com name preenchido e um array step contendo um único HowToStep, tudo dentro da tag script de JSON-LD. Vale entender o vocabulário: name no nível de cima é o nome do tutorial, text dentro do passo é a instrução. O HowToStep aceita ainda name, url e image, que esta versão não emite. Para um tutorial de sete passos, duplique o objeto HowToStep dentro do array.

O aviso honesto: o Google parou de exibir rich results de HowTo nos resultados de busca em setembro de 2023. A marcação continua sendo schema válido e ainda serve para consumo interno, feeds e outros agregadores, mas não conte com o carrossel de passos na SERP. Se o seu conteúdo é receita culinária, o tipo certo é Recipe, não HowTo. Toda a geração acontece no navegador, sem envio de dados.