BreadcrumbList descreve, com dados estruturados, a posição de uma página numa trilha de navegação. A trilha marcada deve corresponder a uma trilha útil e visível na própria página; markup não substitui breadcrumb visual nem garante apresentação especial nos resultados.
Exemplo JSON-LD
Para a página https://exemplo.com.br/biblioteca/seo/como-definir-urls-canonicas/:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Início",
"item": "https://exemplo.com.br/"
},
{
"@type": "ListItem",
"position": 2,
"name": "SEO técnico",
"item": "https://exemplo.com.br/biblioteca/seo/"
},
{
"@type": "ListItem",
"position": 3,
"name": "URLs canônicas"
}
]
}
</script>
A lista tem pelo menos dois ListItem, e position começa em 1 e segue a ordem da trilha. Cada item anterior precisa nome e URL. Para o último, Google permite omitir item; nesse caso ele usa a URL da página. Também é válido informá-la.
Gere com os mesmos dados da navegação
- Defina trilha editorial (por exemplo Início → SEO técnico → URL atual); ela pode não reproduzir literalmente todos os segmentos da URL.
- Gere links do breadcrumb visível e objetos JSON-LD da mesma estrutura de dados para evitar divergência de nome, ordem ou destino.
- Use URLs absolutas HTTPS e canônicas, sem parâmetros de sessão; serialize strings com JSON encoder do framework em vez de montar JSON por concatenação.
- Não inclua rótulos que não aparecem para o usuário nem transforme a trilha em lista de palavras-chave. Não marque como caminho hierárquico elementos que sejam apenas filtros ou tags.
- Teste ao menos uma página de cada nível e um artigo profundo no Rich Results Test. Corrija erros críticos e compare “Exibir HTML testado” com o breadcrumb visível. Depois de publicar, use inspeção de URL no Search Console; o recrawl pode demorar e exibição depende dos sistemas do Google.
Google exige itemListElement com ListItem, posição e nome, além de URL em cada item anterior; consulte Breadcrumb estruturado — Google Search Central. Veja também URLs canônicas e o hub de SEO.