Migrar de WordPress para Astro: como mudar o site, headless ou por completo, sem perder posições no Google

A resposta curta

O WordPress roda em 40,1% de todos os sites, segundo o W3Techs em 13 de outubro de 2026, então a maioria das migrações começa por ele. O próprio guia de migração do Astro descreve dois caminhos: manter o WordPress como headless CMS e deixar o Astro construir o front-end, ou tirar o conteúdo do WordPress de vez.

Em qualquer um dos dois, o trabalho que protege o seu tráfego é o mesmo: manter cada URL que traz visitas, levar junto os títulos e as descrições que o seu plugin de SEO gerava, copiar a pasta de uploads, substituir os plugins que trabalhavam no front-end e dar a cada URL que mudar um redirecionamento permanente. Feito nessa ordem, o novo site pode carregar mais rápido e custar menos para manter, sem começar do zero as posições no Google.

WordPress headless ou migração completa?

O Astro documenta as duas opções: usar o WordPress como headless CMS e migrar do WordPress, onde sugere a ferramenta wordpress-export-to-markdown para o conteúdo.

O que vimos em oito sites WordPress no ar

Em 13 de outubro de 2026, analisamos oito sites feitos em WordPress, do blog de notícias do próprio WordPress.org a grandes publishers, para ver com o que uma migração pode contar:

• Sete dos oito disponibilizavam seus posts publicamente pela API REST, em /wp-json/wp/v2/posts. O oitavo respondeu 401: algumas hospedagens e plugins de segurança bloqueiam a API, então confira a sua antes de planejar em torno dela.
• Três dos oito também retornavam os dados do Yoast SEO com cada post. O Yoast adiciona um campo yoastheadjson às respostas padrão da API REST, com o título, a descrição, a URL canônica, as tags Open Graph e o schema que ele gera para aquela página (documentação para desenvolvedores do Yoast). São os metadados de SEO de que você precisa, prontos para reutilizar.
• Todas as URLs de posts retornadas terminavam com barra, e cinco das sete incluíam o ano, como em /2026/10/nome-do-post/. O Astro precisa reproduzir essa estrutura exatamente, ou cada post vai precisar de um redirecionamento.
• Seis dos oito ainda carregavam jQuery, um lembrete de quanto código de front-end um tema WordPress carrega e que uma reconstrução em Astro pode deixar para trás.

De WordPress para Astro, passo a passo

1. Faça o inventário de todas as URLs. Desde a versão 5.5, o WordPress publica um sitemap em /wp-sitemap.xml, a menos que um plugin de SEO o substitua pelo seu próprio (Make WordPress Core). Acrescente o relatório Páginas do Google Search Console com o maior período disponível, anote a estrutura de links permanentes em Configurações > Links permanentes e exporte as regras de qualquer plugin de redirecionamento.
2. Escolha entre headless e migração completa com a tabela acima. As demais etapas valem para os dois casos; no headless, "exportar" significa ler os mesmos dados da API no momento do build.
3. Exporte o conteúdo. Em Ferramentas > Exportar, o WordPress gera um arquivo WXR, uma exportação em XML com seus posts, páginas, tipos de post personalizados, comentários, campos personalizados, categorias, tags, taxonomias personalizadas e usuários (documentação do WordPress). Para uma exportação por script, a API REST retorna até 100 posts por página, com o HTML já renderizado de cada um.
4. Copie os uploads. As imagens não ficam dentro do arquivo XML: elas estão em wp-content/uploads, junto com as cópias redimensionadas que o WordPress criou de cada uma. Mantenha os originais, deixe o astro:assets gerar os tamanhos e decida se as URLs antigas das imagens continuam iguais ou precisam de redirecionamentos.
5. Leve junto os metadados de SEO. Se o site usa o Yoast SEO, leia o yoastheadjson da API REST para cada post e página: ele traz o título e a descrição finais, e não os modelos que o plugin armazena. Caso contrário, extraia esses dados dos campos personalizados do plugin na exportação.
6. Reconstrua os templates como componentes Astro. Na migração completa, transforme posts e páginas em content collections ou leve-os para um novo CMS; com o WordPress headless, busque-os pela API. Confira o HTML de alguns posts em busca de shortcodes, embeds e marcação de page builders, que muitas vezes precisa de limpeza para ficar certa fora do tema antigo.
7. Substitua os plugins que trabalhavam no front-end. Os formulários precisam de um endpoint próprio (um Cloudflare Worker, um serviço de formulários ou o seu CRM), a busca pode virar um índice estático como o Pagefind, e os comentários pedem uma decisão: mantê-los, levá-los para um serviço ou encerrá-los. Os plugins de cache não têm mais o que fazer quando as páginas são geradas com antecedência.
8. Mantenha a estrutura das URLs. Os links permanentes do WordPress costumam terminar com barra, o que coincide com a saída padrão do Astro em diretórios. Links permanentes com data viram rotas dinâmicas como /[year]/[month]/[slug]/ (roteamento do Astro); os arquivos de categorias e tags precisam de páginas próprias ou de um redirecionamento.
9. Redirecione no servidor, incluindo as sobras do WordPress. Um build estático do Astro sem adaptador transforma os redirecionamentos configurados em páginas de meta refresh (referência de configuração do Astro), então configure redirecionamentos 301 de 1 para 1 onde o site estiver hospedado. Além dos posts que mudarem, cubra as URLs que o WordPress cria por conta própria: /feed/, links curtos ?p=, páginas de anexo, arquivos de autor e qualquer arquivo de /wp-content/uploads/ que você tenha movido.
10. Lance e acompanhe. Troque o DNS, deixe a instalação antiga do WordPress acessível só para você até o novo site ser verificado e acompanhe os relatórios de indexação do Search Console nas semanas seguintes. Nosso checklist de SEO para migração de site cobre o dia do lançamento e os 90 dias seguintes.

O que muda depois da migração

Como manter o SEO intacto

As orientações do Google sobre mudanças de site com alteração de URLs valem aqui: associe cada URL antiga ao equivalente novo mais próximo, use redirecionamentos permanentes no servidor e mantenha-os por pelo menos um ano. O WordPress facilita manter URLs idênticas mais do que a maioria das plataformas, porque seus links permanentes com barra no final coincidem com o padrão do Astro; o trabalho está em reproduzir os caminhos com data, os arquivos e cada URL que algum plugin gerava.

Depois, confira o que o tema e os plugins antigos adicionavam a cada página: tags canonical, imagens Open Graph, dados estruturados, as tags hreflang de um plugin multilíngue e as regras de robots. Tudo o que faltar no novo site é um sinal que o Google perde no dia da troca.

Como a Dardo conduz uma migração do WordPress

Fazemos migrações do WordPress como parte do nosso serviço de migração de site: inventário de URLs e conteúdo, a decisão entre headless e migração completa, uma página representativa reconstruída primeiro e revisada nas larguras combinadas e, depois, o restante dos templates, formulários e redirecionamentos. A construção em si é desenvolvimento web em Astro. Se você ainda está decidindo se vale sair do WordPress, nossa comparação entre WordPress e um site sob medida mostra quando cada um compensa, e nossos guias de migração do Framer e do Webflow cobrem os outros pontos de partida comuns.

Se você está avaliando uma migração, envie o site e o que você quer mudar. Vamos dizer se o headless ou a migração completa faz mais sentido antes de orçar qualquer um dos dois.