Site headless prejudica o SEO
Site headless é o site em que o CMS guarda e entrega o conteúdo por API e outra aplicação, o front-end, monta as páginas. O conceito, e o momento em que essa arquitetura se paga, estão no artigo sobre o que é headless CMS.
Para o SEO, a arquitetura muda quem responde por cada sinal: tudo o que o tema e os plugins do CMS escreviam no HTML, como title, canonical, sitemap e dados estruturados, passa a depender do código do front-end. As condições que o Google precisa encontrar seguem as mesmas descritas no guia de SEO técnico: rastrear, renderizar e indexar a versão certa de cada página. Se o WordPress é a fonte de conteúdo, a implementação está no artigo sobre headless WordPress.
O que muda na renderização quando o front fica separado
No modelo tradicional, o servidor do CMS devolve a página pronta. No headless, quem monta a página é o framework do front-end, e cada um segue um padrão próprio. A documentação do Astro ↗[1], consultada em 14/10/2026, informa que as páginas são pré-renderizadas como HTML estático na geração do site e que a renderização sob demanda exige um adaptador. A documentação do Next.js sobre renderização ↗[2], atualizada em 30/03/2026, descreve uma casca estática enviada primeiro e partes dinâmicas que chegam em streaming na mesma resposta.
O guia de JavaScript SEO do Google ↗[3], atualizado em 04/03/2026, mostra por que essa escolha pesa: as páginas passam por rastreamento, renderização e indexação, e a renderização tem fila própria. O mesmo guia diz que renderizar no servidor ou pré-renderizar continua sendo “a great idea”, porque nem todos os robôs executam JavaScript.
Renderização no servidor, estática ou no navegador
| Modo | Quando o HTML é gerado | O que o robô recebe no primeiro pedido | Ponto de atenção para SEO |
|---|---|---|---|
| SSR, renderização no servidor | a cada pedido | página completa | tempo de resposta e status code de cada rota |
| SSG, geração estática | na publicação | página completa, já pronta | conteúdo novo só entra depois de nova geração; o sitemap acompanha |
| CSR, renderização no navegador | no navegador, depois que o JavaScript roda | HTML quase vazio e arquivos de JavaScript | fila de renderização, robôs sem JavaScript, cada arquivo é um pedido a mais |
| Hidratação | servidor ou publicação, e o JavaScript torna a página interativa | página completa | o conteúdo não pode depender só da parte que hidrata |
A documentação do Google sobre renderização dinâmica ↗[4], atualizada em 10/12/2025, classifica a entrega de uma versão só para robôs como contorno não recomendado e indica renderização no servidor, renderização estática ou hidratação. Para o detalhe sobre JavaScript em qualquer arquitetura, veja o guia de JavaScript SEO.
Como ficam cache, sitemap e canonical
Cache: a página do Google sobre problemas de JavaScript ↗[5], atualizada em 18/12/2025, recomenda impressão digital no nome dos arquivos de JavaScript e CSS, para que o Googlebot não use versões antigas guardadas em cache, e avisa que armazenamento local e cookies são apagados entre carregamentos. Na geração estática, o cache da página também define quando o conteúdo alterado no CMS chega ao robô. A Studio Visual recomenda que publicar, despublicar ou alterar o slug de uma página no CMS dispare a revalidação da página, das listagens em que ela aparece e do sitemap, para que robô e visitante recebam a mesma versão. Se a revalidação vem de um evento disparado pelo CMS ou de um intervalo de tempo, e quanto dura o cache, depende do framework, da hospedagem e da frequência de publicação de cada site.
Sitemap: o arquivo passa a ser gerado pelo front-end a partir das URLs do CMS. No Next.js, a convenção sitemap ↗[6], atualizada em 18/08/2026, gera o arquivo por código, com cache por padrão, e permite dividir sitemaps grandes. Vale conferir se uma página publicada, despublicada ou com slug alterado no CMS muda o sitemap na mesma hora.
Canonical e hreflang: no Next.js, a API de metadados ↗[7], atualizada em 19/08/2026, gera canonical e hreflang pelo campo alternates, combinado com um endereço-base. A mesma página informa que metadados resolvidos depois do envio inicial podem ir em streaming, anexados ao body, forma verificada com robôs que executam JavaScript, como o Googlebot; robôs limitados a HTML recebem os metadados no head. A documentação de canonical do Google ↗[8], atualizada em 10/07/2026, pede a tag no código-fonte e uma tag só por página.
Checklist do que costuma quebrar em headless
| Item | O que quebra | Como validar em produção |
|---|---|---|
| Status code | página inexistente responde 200; no Next.js, a tela de não encontrado depois do início do streaming sai com 200 e noindex | resposta HTTP de uma URL inexistente |
| Canonical | aponta para o domínio de homologação ou para a URL do CMS | código-fonte e URL canônica escolhida pelo Google na inspeção de URL |
| Sitemap | lista URLs do CMS, de rascunho ou com slug antigo | comparar o sitemap com as URLs publicadas e com o relatório de sitemaps |
| Paginação | páginas 2, 3 e seguintes carregadas por botão, sem URL própria nem link com href | código-fonte das páginas de listagem |
| Redirecionamento | slug alterado no CMS sem 301 no front-end | resposta HTTP da URL antiga |
| Robots | noindex ou bloqueio da homologação publicado em produção | /robots.txt e meta robots no código-fonte |
| Dados estruturados | JSON-LD que o plugin gerava deixa de existir | Teste de pesquisa aprimorada |
Fontes do comportamento do Next.js: documentação de not-found ↗[9], atualizada em 06/10/2026. Regras de status, links e redirecionamento: guia de JavaScript do Google e documentação de redirecionamentos ↗[10], atualizada em 14/04/2026.
Como testar o que o robô enxerga
- Leia a resposta crua: o código-fonte da página, sem executar JavaScript, mostra o que robôs sem renderização recebem.
- Inspecione no Search Console: a inspeção de URL mostra o HTML renderizado, os recursos carregados e os erros do console.
- Compare os dois: texto principal, title, canonical, links e dados estruturados precisam estar nas duas versões.
- Teste URLs de erro: endereço inexistente, slug antigo e página despublicada no CMS.
- Acompanhe as estatísticas de rastreamento: o relatório mostra a atividade do Googlebot e do serviço de renderização do Google.
- Leia os logs: a análise de logs mostra se o Googlebot pede as páginas novas e os arquivos de JavaScript.
Que erro de headless derruba a indexação
Pela documentação do Google, três erros têm efeito direto no índice: conteúdo principal que só aparece depois do JavaScript, noindex no HTML original (o Google pode pular a renderização e não ver o script que o remove) e páginas de erro que respondem 200, tratadas como soft 404. O primeiro atinge o site inteiro de uma vez, e os outros dois, grupos de páginas.
A mesma questão, de renderização e do que o robô recebe, aparece em sites criados por ferramentas de IA, tema do artigo sobre SEO em site feito com IA.
OPINIÃO DE ESPECIALISTA
“Num site headless, a correção que eu priorizo é fazer o HTML do primeiro pedido carregar o essencial: texto principal, title, canonical, links com href e status code certo, porque quase todo o resto do checklist depende disso. A posição da Studio Visual é usar renderização no servidor ou geração estática em toda página que precisa ser encontrada na busca e reservar a renderização no navegador para áreas logadas e partes interativas. O Google renderiza JavaScript com fila própria, e o próprio guia dele lembra que nem todo robô executa JavaScript. Antes de publicar, cada modelo de página passa pela conferência no código-fonte e na inspeção de URL.”
Amanda Noronha
Head de SEO
Próximo passo
Para conferir o que o Google recebe do seu site headless antes ou depois do lançamento, a página do serviço de SEO técnico mostra como a Studio Visual testa renderização, status code e sinais de indexação em produção.
