O SEO é uma parte crucial do sucesso online, e o Rank Math é uma das ferramentas mais populares para gerenciar SEO em sites WordPress. No entanto, ao usar o Rank Math, você pode encontrar o erro “Either ‘name’ or ‘item.name’ should be specified” ao verificar o desempenho do seu site no Google Search Console ou ao utilizar a ferramenta de teste de resultados avançados do Google. Este artigo detalhado irá guiá-lo por todo o processo de identificação e correção desse erro, garantindo que seu site esteja otimizado e livre de problemas técnicos que possam impactar negativamente seu SEO.
O Que Significa o Erro “Either ‘name’ or ‘item.name’ should be specified”?
Antes de abordarmos as soluções, é essencial entender o que esse erro significa. Este erro está relacionado ao Breadcrumb Schema, que é uma parte vital para a navegação e estruturação de sites em termos de SEO. O Breadcrumb Schema ajuda os motores de busca a entender a hierarquia do conteúdo em seu site.
O erro “Either ‘name’ or ‘item.name’ should be specified” indica que, em algum lugar no seu Breadcrumb Schema, falta um nome ou item.name. Isso geralmente acontece quando uma postagem, categoria ou outro elemento do breadcrumb não possui um título definido. Se o título estiver ausente, o Google não consegue identificar corretamente o item, resultando nesse erro.
Você pode ver esse erro ao testar o esquema do seu site usando a ferramenta de teste de resultados avançados do Google ou diretamente no Google Search Console.
Como o Rank Math Lida Com Esse Erro
O Rank Math foi desenvolvido para gerenciar adequadamente situações em que esses erros poderiam aparecer. Em vez de adicionar um elemento ao Breadcrumb Schema sem um item.name, o Rank Math simplesmente ignora o elemento faltante. Isso significa que, na maioria dos casos, você não verá esse erro.
No entanto, se você deixar o título da postagem ou o título do breadcrumb em branco, o Rank Math não terá dados para adicionar ao esquema, e, provavelmente, você verá esse erro. Para resolver isso, o Rank Math oferece várias soluções que vamos explorar a seguir.
Como Corrigir o Erro “Either ‘name’ or ‘item.name’ should be specified”
Existem várias abordagens para corrigir esse erro, dependendo da situação específica em que você se encontra. Vamos explorar cada uma delas em detalhes:
1. Corrigir o Erro Adicionando um Título à Página ou Postagem
A solução mais simples e direta para este erro é garantir que todas as suas postagens e páginas tenham um título definido. Aqui está como você pode fazer isso:
1.1 Abrir a Postagem/Página
Primeiro, localize a postagem ou página que está gerando o erro. No painel do WordPress, vá até a seção de Postagens ou Páginas, encontre o item problemático e clique na opção Editar.
1.2 Adicionar um Título
No editor do WordPress, certifique-se de que a postagem ou página tenha um título. Se não tiver, adicione um título que seja relevante para o conteúdo.
1.3 Atualizar/Publicar a Postagem
Depois de adicionar o título, clique em Atualizar se for uma postagem existente, ou em Publicar se for uma nova postagem.
Essa simples adição pode resolver imediatamente o erro de schema relacionado ao item.name.
2. Corrigir o Erro Com um Título de Breadcrumb
Em alguns casos, especialmente quando se lida com postagens personalizadas que não utilizam títulos, adicionar um título de breadcrumb pode ser a solução necessária.
2.1 Editar a Postagem/Página
Assim como na solução anterior, vá até a postagem ou página que está gerando o erro e clique em Editar.
2.2 Abrir o Rank Math no Editor Gutenberg
No editor Gutenberg, clique no ícone Rank Math SEO no canto superior direito da tela. Alternativamente, você pode clicar nos três pontos verticais e escolher Rank Math na seção de Plugins.
2.3 Navegar até a Aba Avançada
Na caixa Meta do Rank Math que aparecerá na tela, clique na aba Avançado.
2.4 Adicionar o Título de Breadcrumb
Na aba Avançada, você encontrará a opção de adicionar um Título de Breadcrumb. Insira um título apropriado para garantir que o schema do breadcrumb seja completo.
2.5 Atualizar/Postar a Página
Depois de adicionar o título de breadcrumb, clique em Atualizar ou Publicar para aplicar as mudanças.
3. Usando Código para Alterar Títulos de Breadcrumb em Massa
Se você tem muitas postagens sem título ou se o processo manual de adicionar títulos de breadcrumb é muito demorado, você pode optar por usar um snippet de código que alterará o título do breadcrumb em massa.
3.1 Navegar até o Editor de Arquivos do Tema
No painel do WordPress, vá para Aparência → Editor de Arquivos do Tema (para temas clássicos) ou Ferramentas → Editor de Arquivos do Tema (para temas de bloco).
Na lista de arquivos à direita da tela, escolha o arquivo rank-math.php.
3.2 Adicionar o Snippet de Código
No editor de código que aparece no meio da tela, insira o seguinte snippet de código. Certifique-se de substituir “Example” no snippet abaixo por um título relevante para o seu site:
<?php
/**
* Filtro para permitir a alteração ou remoção dos itens de Breadcrumb
* Define um título de breadcrumb personalizado se a postagem não tiver nenhum título
*
* @param array $crumbs O array de breadcrumbs.
* @param Breadcrumbs $this Objeto breadcrumb atual.
*/
add_filter(
'rank_math/frontend/breadcrumb/items',
function ( $crumbs, $class ) {
// Verifica se estamos visualizando postagens individuais e se as postagens têm um título.
if ( is_singular( 'post' ) && empty( trim( get_the_title() ) ) ) {
$new_breadcrumb_title = 'Example'; // Altere o título de acordo com o seu site.
// O último elemento no array $crumbs é o título do breadcrumb da postagem, então precisamos atualizá-lo.
$crumbs[ count( $crumbs ) - 1 ][0] = $new_breadcrumb_title;
}
// E retorna os breadcrumbs.
return $crumbs;
},
10,
2
);
3.3 Atualizar o Arquivo
Depois de adicionar o snippet de código, clique no botão Atualizar Arquivo na parte inferior da tela para salvar as alterações.
Agora você pode confirmar se o erro foi corrigido testando o código-fonte da página usando a ferramenta de teste de resultados avançados do Google.
Conclusão
O erro “Either ‘name’ or ‘item.name’ should be specified” pode parecer intimidador, especialmente se você não estiver familiarizado com schemas e SEO técnico. No entanto, como mostrado neste guia, o Rank Math oferece várias maneiras de corrigir esse problema, desde soluções simples como adicionar títulos a postagens até métodos mais avançados como a utilização de snippets de código.
Ao garantir que todos os elementos de breadcrumb tenham títulos adequados, você não só corrige o erro, mas também melhora a estrutura e a navegabilidade do seu site, impactando positivamente seu SEO geral. Se você ainda estiver enfrentando problemas, a equipe de suporte do Rank Math está sempre pronta para ajudar.
Este artigo foi desenvolvido para fornecer um guia completo sobre como resolver o erro “Either ‘name’ or ‘item.name’ should be specified” no Rank Math, garantindo que seu site permaneça otimizado e livre de erros que possam prejudicar sua presença online.
Se você ainda não está usando o Rank Math, considere explorar suas versões gratuitas e PRO para aprimorar seu SEO e obter melhores resultados nos motores de busca.
Este artigo foi projetado com as melhores práticas de SEO em mente, utilizando palavras-chave relevantes como “RankMath SEO”, “Rank Math”, “Rank Math SEO”, “Either ‘name’ error”, “‘item.name’ error”, e “error ‘Either ‘name’ or ‘item.name’ should be specified” de maneira natural e estratégica para garantir uma boa performance nos motores de busca.