Como corrigir erros de sitemap no Google Search Console
Por Pablo Murad. Atualizado em
Abra o sitemap no relatório de Sitemaps, leia o erro exato na página de detalhes e encontre-o nas tabelas abaixo. Cada linha traz o texto do Google para a mensagem, a causa e a correção. Os erros se dividem em dois grupos: o Google não conseguiu buscar o arquivo, ou buscou e não conseguiu lê-lo sem problemas.
O que significam os status do relatório de Sitemaps
O relatório mostra o resultado da última requisição do Google para cada sitemap. Segundo a ajuda do relatório de Sitemaps, ele lista apenas sitemaps enviados pelo próprio relatório ou pela API do Search Console, só da propriedade atual, e mostra no máximo 1.000 envios. Um sitemap que o Google achou pelo robots.txt não aparece.
| Status ou mensagem | O que significa | O que fazer |
|---|---|---|
| Success | O Google buscou o sitemap e o leu sem erros. Todas as URLs dele entram na fila de rastreamento. | Nada a corrigir. |
| Has errors | O Google buscou o sitemap, mas encontrou um ou mais erros. As URLs que ele conseguiu ler sem erro continuam na fila. | Abra o sitemap no relatório para ver a lista de erros. |
| Couldn't fetch | O Google não conseguiu obter o arquivo do sitemap. | Passe pelos erros de busca abaixo. |
| Sitemap had X errors | O Google buscou o sitemap e leu parte dele, mas encontrou alguns erros. | Expanda os erros e corrija. |
| Sitemap could not be read | A mensagem da página de detalhes quando a busca falhou. | Corrija o problema e reenvie o sitemap. |
| Sitemap can be read, but has errors | A mensagem da página de detalhes quando o Google leu o arquivo e listou erros. | Revise cada erro da lista. |
Se a busca falha, o Google tenta de novo por alguns dias e depois desiste; corrija a causa e reenvie. Problemas em URLs individuais dentro de um sitemap não impedem o Google de ler o resto.
"Couldn't fetch": por que o Google não consegue obter o arquivo
Esse status significa que o Google não conseguiu obter o arquivo do sitemap em si. O Google lista cinco motivos possíveis.
| Motivo (texto do Google) | Causa e correção | GenMap |
|---|---|---|
| The sitemap is blocked by your robots.txt file. | O Google respeita o robots.txt ao buscar sitemaps. Remova a regra que bloqueia o arquivo. | Fora do rastreio. Teste a regra com o testador de robots.txt. |
| Your site has a manual action. | Sitemaps não são lidos enquanto há uma ação manual pendente. Veja o relatório de Ações manuais, resolva o problema e reenvie o sitemap. | Não é um problema de sitemap. |
| The URL provided for the sitemap is wrong (HTTP 404 error: sitemap not found at the address provided). | Abra a URL num navegador e confira se o arquivo existe. | Envie o arquivo exatamente para o caminho que você submeter e abra essa URL você mesmo. |
| Some other general error. | Indisponibilidade do servidor, por exemplo. Alguns desses erros são passageiros: espere e veja se as próximas tentativas dão o mesmo erro. | Nada a mudar no arquivo. |
| There is low crawl demand for the sitemap. | O Google liga a demanda de rastreamento à qualidade do conteúdo do site: quanto maior a qualidade, maior a demanda. | Nada a mudar no arquivo. |
Como depurar um erro de busca
- Clique no sitemap no relatório e depois no nome do erro para ver os detalhes.
- Copie a URL do sitemap da página de detalhes e cole na ferramenta de Inspeção de URL.
- Clique em "Live test" e expanda a seção "Page availability".
- Confira se "Crawl allowed?" mostra "Yes" e se "Page fetch" mostra "Successful".
Os passos vêm da ajuda do Google sobre a ferramenta de Inspeção de URL e o relatório de Sitemaps. Os rótulos acima estão como o Google os documenta em inglês; no seu Search Console eles podem aparecer traduzidos.
Erros de leitura: o arquivo carrega, mas o Google não o lê sem problemas
Esses erros aparecem depois que o Google buscou o arquivo. O Google diz que a lista dele não é completa, mas cobre quase tudo o que você vai ver. O Search Console pode mostrar as mensagens traduzidas para o seu idioma; o texto em inglês abaixo é como o Google as documenta. A última coluna descreve o que o GenMap faz ao escrever o arquivo.
| Mensagem | Causa e correção (Google) | GenMap |
|---|---|---|
| URLs not accessible | O Google encontrou um erro ao rastrear uma URL do sitemap. Inspecione a URL com a ferramenta de Inspeção de URL. | Lista só páginas que retornaram 200 quando foram rastreadas. Rastreie de novo depois de um deploy. |
| URLs not followed | Redirecionamentos demais ou URLs relativas. Troque as URLs que redirecionam pelas finais, use links absolutos e evite redirecionamentos por JavaScript ou meta refresh. | Escreve a URL final depois de um redirecionamento, completa. |
| URL not allowed | O sitemap inclui URLs de um nível acima ou de outro domínio em relação ao arquivo. Faltar o www, ou usar outro protocolo, como https para um sitemap servido em http, conta como domínio diferente. | Envie o arquivo para a raiz do site rastreado, com o mesmo protocolo e host. |
| Compression error | O Google não conseguiu descompactar o arquivo. Recompacte com uma ferramenta como o gzip, envie e reenvie o sitemap. | Gera o arquivo gzip por conta própria. Baixe de novo e envie sem alterar. |
| Empty sitemap | O arquivo não contém URLs. | Se o rastreio não encontra nenhuma página indexável, o relatório lista por que as páginas ficaram de fora. |
| Sitemap file size error: Your sitemap exceeds the maximum file size limit. | O arquivo passa de 50 MB descompactado. Divida em sitemaps menores, liste-os em um índice de sitemaps e envie o índice. | Divide acima dos limites e escreve o índice. |
| Invalid attribute value | Um atributo XML tem valor inválido. Confira se só há atributos permitidos, com valores permitidos, e procure erros de digitação. | Os atributos vêm do gerador, não de XML digitado à mão. |
| Invalid date | Uma data está no formato errado ou não é uma data real. Use W3C Datetime, como 2005-02-21 ou 2005-02-21T18:00:15+00:00. Se incluir a hora, inclua o fuso. | Escreve o lastmod no formato W3C com deslocamento UTC e o omite quando a página não informa data. |
| Invalid tag value | Uma tag tem valor inválido. Consulte a especificação do seu tipo de sitemap. | Os valores das tags vêm dos dados do rastreio, e o gerador de XML faz o escape. |
| Invalid URL | Uma URL tem caracteres não suportados, espaços, aspas ou um esquema malformado, como htp://. Codifique e faça o escape das URLs e tente colar a URL num navegador. | Escreve as URLs que rastreou. O gerador de XML faz o escape de &, < e >. |
| Invalid URL in sitemap index file: incomplete URL | O índice não traz a URL completa de cada sitemap, então o Google procura no diretório do próprio índice. Use o caminho completo de cada sitemap e reenvie. | Confira as linhas loc do índice e faça-as coincidir com as URLs onde você envia cada arquivo. |
| Invalid XML: too many tags | Uma entrada tem tags duplicadas, como duas tags loc. O erro indica a tag e a linha. Remova a duplicata e reenvie. | Escreve um loc por entrada url. |
| Missing XML attribute | Uma tag não tem um atributo obrigatório. Acrescente e reenvie. | Os atributos vêm do gerador, não de XML digitado à mão. |
| Missing XML tag | Uma entrada não tem uma tag obrigatória. O erro informa o número da linha. | Toda entrada url recebe um loc. |
| Incorrect sitemap index format: Nested sitemap indexes | Um índice lista a si mesmo ou outro índice. Um índice só pode listar arquivos de sitemap. Remova essas entradas e reenvie. | O índice lista apenas arquivos de sitemap. |
| Parsing error | O Google não conseguiu ler o XML, em geral por um caractere sem escape numa URL. Os valores precisam trazer & ' " < > como entidades XML. | O gerador de XML faz o escape dos caracteres especiais. |
| Temporary error | O Google teve um problema temporário ao processar o sitemap. Em geral não é preciso reenviar. Se o erro continuar depois de várias horas, reenvie. | Nada a mudar no arquivo. |
| Too many sitemaps | O índice lista mais de 50.000 sitemaps. Divida em vários índices de no máximo 50.000 sitemaps cada. | Fora de alcance: o teto de 1.600.000 páginas do maior plano cabe em 32 arquivos de 50.000 URLs. |
| Too many URLs | O sitemap lista mais de 50.000 URLs. Divida em vários sitemaps ou use um índice de sitemaps. | Divide no limite e escreve o índice. |
| Unsupported format | O arquivo não está num formato suportado. Causas comuns: cabeçalho errado, namespace diferente de http://www.sitemaps.org/schemas/sitemap/0.9, ou aspas curvas nos atributos, que processadores de texto podem inserir. | Escreve a declaração XML e o namespace por conta própria. Se editar o arquivo, use um editor de texto simples. |
| Path mismatch: Missing www | A URL do sitemap não tem www, mas as URLs listadas têm. Faça-as coincidir. | As URLs levam o host do site rastreado. Envie o arquivo nesse mesmo host. |
| Path mismatch: Includes www | A URL do sitemap tem www, mas as URLs listadas não têm. Faça-as coincidir. | As URLs levam o host do site rastreado. Envie o arquivo nesse mesmo host. |
| Incorrect namespace | O elemento raiz tem um namespace errado, com erro de digitação ou mal declarado. Um sitemap usa xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"; um sitemap de vídeo acrescenta xmlns:video="http://www.google.com/schemas/sitemap-video/1.1". | Escreve o namespace de cada tipo de arquivo que gera. |
| Leading whitespace | O arquivo começa com espaço em branco em vez da declaração XML. O Google ainda processa o sitemap, mas remova o espaço para seguir o padrão XML. | O arquivo começa com a declaração XML. |
| HTTP error [specific code] | O Google recebeu um erro HTTP da faixa 400 ao baixar o sitemap, e a mensagem mostra o código. Confira a URL e se o arquivo existe ali, e reenvie. | Confira o caminho onde você enviou o arquivo. |
| General HTTP error | Outro erro HTTP. Expanda os detalhes para ver qual. Também pode ser um 404, que é um erro de busca. | Confira o caminho onde você enviou o arquivo. |
| Sitemap contains urls which are blocked by robots.txt | O robots.txt bloqueia o sitemap ou parte do conteúdo dele. Use a Inspeção de URL para achar o arquivo bloqueado e edite o robots.txt para liberar o Googlebot. | O rastreador checa o robots.txt antes de buscar uma página. Teste qualquer URL com o testador de robots.txt. |
Erros de sitemap de vídeo e de notícias
| Mensagem | Causa e correção (Google) |
|---|---|
| Missing thumbnail URL | Uma entrada de vídeo está sem URL de miniatura. Acrescente com a tag video:thumbnail_loc. |
| Missing video title | Uma entrada de vídeo está sem título. Acrescente com a tag video:title. |
| Thumbnail too large | A miniatura do vídeo é grande demais. Redimensione para 160 x 120 px. |
| Thumbnail too small | A miniatura do vídeo é pequena demais. Redimensione para 160 x 120 px. |
| Video location and play page location are the same | Se você informa video:player_loc e video:content_loc, as duas URLs precisam ser diferentes. |
| Video location URL appears to be a play page URL | A URL de video:content_loc aponta para a página que hospeda o player. Aponte para o arquivo de vídeo. |
| Too many News URLs | Um sitemap de notícias lista mais de 1.000 URLs. Reduza as URLs por arquivo. |
| Missing <publication> tag | Cada URL de um sitemap de notícias precisa da tag publication. Acrescente em todas as URLs. |
Como evitar erros de sitemap desde o começo
A maioria das linhas acima descreve um arquivo editado à mão ou publicado no lugar errado. Um gerador elimina a primeira causa. O GenMap escreve o XML com a declaração e o namespace certos, faz o escape dos caracteres especiais, formata o lastmod no padrão W3C ou o omite, divide arquivos acima de 50.000 URLs e monta o índice. Ele também lista só páginas que retornam 200, não têm noindex e são o próprio canônico, então redirecionamentos, erros e duplicatas não chegam ao arquivo.
Onde você publica o arquivo fica por sua conta, e isso cobre os erros que sobram: caminho, host e regras do robots.txt. Confira o arquivo antes de enviar com o validador de sitemap e o testador de robots.txt, ambos gratuitos. O guia de sitemap XML explica o formato.
Fontes
- Relatório de Sitemaps, Ajuda do Search Console, conferido em 21 de outubro de 2026.
- Criar e enviar um sitemap, Google Search Central.
- O protocolo do sitemaps.org.
Comece de um sitemap feito para passar no relatório.
Rastrear um site