--- title: "Migrar de WordPress para Astro sem perder o SEO — Dardo" description: "Migrar de WordPress para Astro, headless ou por completo: exportar posts e metadados do Yoast, manter os links permanentes e redirecionar as URLs." url: "https://dardo.studio/pt/blog/migrar-de-wordpress-para-astro/" language: "pt" translations: {"en":"https://dardo.studio/en/blog/wordpress-to-astro/","es":"https://dardo.studio/es/blog/migrar-de-wordpress-a-astro/","fr":"https://dardo.studio/fr/blog/migrer-wordpress-vers-astro/","de":"https://dardo.studio/de/blog/wordpress-zu-astro-migrieren/","it":"https://dardo.studio/it/blog/migrare-da-wordpress-ad-astro/","nl":"https://dardo.studio/nl/blog/wordpress-naar-astro/","sv":"https://dardo.studio/sv/blogg/migrera-wordpress-till-astro/","pl":"https://dardo.studio/pl/blog/migracja-z-wordpressa-do-astro/","uk":"https://dardo.studio/uk/blog/wordpress-to-astro/","ru":"https://dardo.studio/ru/blog/wordpress-to-astro/","ar":"https://dardo.studio/ar/blog/wordpress-to-astro/","hi":"https://dardo.studio/hi/blog/wordpress-to-astro/","th":"https://dardo.studio/th/blog/wordpress-to-astro/","ja":"https://dardo.studio/ja/blog/wordpress-to-astro/","ko":"https://dardo.studio/ko/blog/wordpress-to-astro/","zh-Hans":"https://dardo.studio/zh-Hans/blog/wordpress-to-astro/","zh-Hant":"https://dardo.studio/zh-Hant/blog/wordpress-to-astro/"} updated: "2026-10-13T02:37:50.885Z" --- [Blog](https://dardo.studio/pt/blog/) # Migrar de WordPress para Astro: como mudar o site, headless ou por completo, sem perder posições no Google Migrar de WordPress para Astro, headless ou por completo: o que exportar, como manter títulos do Yoast, permalinks e uploads, e as URLs que muitos esquecem. Por [Nicolás Cerón](https://dardo.studio/pt/estudio/) ·12 de outubro de 2026 ![Um grande casarão antigo à noite, com andaimes e janelas iluminadas, e um baú de viagem carmesim sobre um carrinho de mão no caminho de pedras que sobe até um pequeno observatório iluminado na colina.](https://dardo.studio/_astro/01M4SH202BB16HWS7MBCWHNP1S_Z2cx2K1.webp) ## Pontos-chave - Você pode manter o WordPress como headless CMS por trás do Astro ou tirar o conteúdo dele de vez; o trabalho de SEO para manter URLs e metadados é o mesmo nos dois casos. - Ferramentas > Exportar gera um arquivo WXR com posts, páginas, comentários, campos personalizados e taxonomias; as imagens ficam em wp-content/uploads e precisam ser copiadas à parte. - Com o Yoast SEO, a API REST retorna no yoast\_head\_json o título, a descrição, a canonical e as tags Open Graph finais de cada página, prontos para reutilizar. - Os links permanentes do WordPress terminam com barra, como a saída padrão do Astro; reproduza os caminhos com data usando rotas dinâmicas em vez de redirecioná-los. - Redirecione também as URLs que o WordPress gera por conta própria: feeds, links curtos ?p=, páginas de anexo, arquivos de autor e os uploads que você tiver movido. ## A resposta curta O WordPress roda em 40,1% de todos os sites, segundo o [W3Techs](https://w3techs.com/technologies/details/cm-wordpress) 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](https://docs.astro.build/en/guides/migrate-to-astro/from-wordpress/) 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? | | Manter o WordPress como headless CMS | Tirar o conteúdo do WordPress | | --------------------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | | Edição | O mesmo painel do WordPress | Um novo CMS ou arquivos Markdown no repositório | | De onde o Astro lê | A API REST do WordPress ou o WPGraphQL | Content collections ou a API do novo CMS | | WordPress para manter | Sim: hospedagem, atualizações e patches de segurança, embora ele não precise mais ficar exposto ao público | Nenhum | | Plugins | Os plugins de edição continuam funcionando; tudo o que rodava no tema precisa ser refeito | Tudo o que você ainda precisa é refeito ou substituído | | Melhor quando | Uma equipe editorial grande trabalha bem no WordPress | O site muda pouco, ou a equipe vai trocar de CMS de qualquer forma | O Astro documenta as duas opções: [usar o WordPress como headless CMS](https://docs.astro.build/en/guides/cms/wordpress/) e [migrar do WordPress](https://docs.astro.build/en/guides/migrate-to-astro/from-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 yoast_head_json à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](https://developer.yoast.com/customization/apis/rest-api/)). 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](https://make.wordpress.org/core/2020/07/22/new-xml-sitemaps-functionality-in-wordpress-5-5/)). 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](https://wordpress.org/documentation/article/tools-export-screen/)). Para uma exportação por script, a [API REST](https://developer.wordpress.org/rest-api/reference/posts/) 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](https://docs.astro.build/en/guides/images/) 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 yoast_head_json 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](https://docs.astro.build/en/guides/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](https://pagefind.app/), 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](https://docs.astro.build/en/guides/routing/)); 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](https://docs.astro.build/en/reference/configuration-reference/)), 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](https://dardo.studio/pt/blog/checklist-seo-migracao-de-site/) cobre o dia do lançamento e os 90 dias seguintes. ## O que muda depois da migração | Área | No WordPress | No Astro | | ------------ | ------------------------------------------ | ------------------------------------------------------------------------ | | Edição | Painel e editor de blocos do WordPress | WordPress como headless CMS, outro CMS ou Markdown | | Hospedagem | Um servidor PHP e um banco de dados | Qualquer hospedagem estática ou plataforma edge, como a Cloudflare | | Atualizações | Núcleo, tema e plugins para manter em dia | Atualizações de dependências no repositório, nenhuma no servidor público | | Formulários | Um plugin de formulários | Endpoint e armazenamento próprios | | Busca | A busca do WordPress ou um plugin de busca | Um índice estático ou um serviço de busca | | Desempenho | Plugins de cache e otimização | Páginas geradas com antecedência, JavaScript só onde você adicionar | ## Como manter o SEO intacto As orientações do Google sobre [mudanças de site com alteração de URLs](https://developers.google.com/search/docs/crawling-indexing/site-move-with-url-changes) 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](https://dardo.studio/pt/servicos/migracao-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](https://dardo.studio/pt/servicos/desenvolvimento-web/) em Astro. Se você ainda está decidindo se vale sair do WordPress, nossa comparação entre [WordPress e um site sob medida](https://dardo.studio/pt/blog/wordpress-ou-site-sob-medida/) mostra quando cada um compensa, e nossos guias de migração do [Framer](https://dardo.studio/pt/blog/migrar-de-framer-para-astro/) e do [Webflow](https://dardo.studio/pt/blog/migrar-de-webflow-para-astro/) cobrem os outros pontos de partida comuns. Se você está avaliando uma migração, [envie o site e o que você quer mudar](https://dardo.studio/pt/contato/?service=website-migration). Vamos dizer se o headless ou a migração completa faz mais sentido antes de orçar qualquer um dos dois. ## Perguntas frequentes **Dá para usar o WordPress com o Astro?** Sim. O WordPress pode continuar como headless CMS: os editores seguem usando o painel do WordPress e o Astro constrói o site público a partir da API REST ou do WPGraphQL. O Astro documenta essa configuração no guia de WordPress como CMS. **Como exportar o conteúdo do WordPress para o Astro?** Use Ferramentas > Exportar para gerar um arquivo WXR e converta-o com uma ferramenta como o wordpress-export-to-markdown, ou leia os posts pela API REST, até 100 por requisição. Copie o wp-content/uploads à parte, porque as imagens não vêm dentro do arquivo exportado. **Vou perder posições no Google se migrar do WordPress para o Astro?** Não, se toda URL que gera tráfego continuar funcionando. Mantenha a estrutura de links permanentes, incluindo a barra no final, leve junto títulos, descrições e dados estruturados, crie redirecionamentos 301 para o que mudar e acompanhe o Search Console por algumas semanas após o lançamento. **O que acontece com os meus plugins do WordPress?** Os plugins que ajudam os editores podem continuar funcionando em uma configuração headless, mas tudo o que rodava no tema, como formulários, sliders, busca, comentários ou page builders, precisa ser refeito ou substituído, porque o Astro gera as páginas públicas por conta própria. **O Astro é mais rápido que o WordPress?** Um site em Astro é gerado com antecedência e só envia JavaScript onde você adiciona, então não precisa de um servidor PHP nem de plugins de cache para responder a cada visita. Quanto mais rápido ele fica depende do que o tema do WordPress carregava, então meça antes e depois. ## Fontes e leituras adicionais Fontes desta página, com mais detalhes dos publicadores originais. - [W3Techs: estatísticas de uso e participação de mercado do WordPress (em inglês)](https://w3techs.com/technologies/details/cm-wordpress) · w3techs.com - [Documentação do Astro: Migrar do WordPress](https://docs.astro.build/en/guides/migrate-to-astro/from-wordpress/) · docs.astro.build - [Documentação do Astro: WordPress headless e Astro](https://docs.astro.build/en/guides/cms/wordpress/) · docs.astro.build - [Documentação do WordPress: tela Ferramentas > Exportar (em inglês)](https://wordpress.org/documentation/article/tools-export-screen/) · wordpress.org - [Manual da API REST do WordPress: Posts (em inglês)](https://developer.wordpress.org/rest-api/reference/posts/) · developer.wordpress.org - [Make WordPress Core: os novos sitemaps XML do WordPress 5.5 (em inglês)](https://make.wordpress.org/core/2020/07/22/new-xml-sitemaps-functionality-in-wordpress-5-5/) · make.wordpress.org - [Documentação para desenvolvedores do Yoast: API REST (em inglês)](https://developer.yoast.com/customization/apis/rest-api/) · developer.yoast.com - [wordpress-export-to-markdown no GitHub (em inglês)](https://github.com/lonekorean/wordpress-export-to-markdown) · github.com - [Documentação do Astro: Content collections](https://docs.astro.build/en/guides/content-collections/) · docs.astro.build - [Documentação do Astro: Imagens](https://docs.astro.build/en/guides/images/) · docs.astro.build - [Documentação do Astro: Roteamento](https://docs.astro.build/en/guides/routing/) · docs.astro.build - [Documentação do Astro: Referência de configuração](https://docs.astro.build/en/reference/configuration-reference/) · docs.astro.build - [Pagefind: busca estática (em inglês)](https://pagefind.app/) · pagefind.app - [Google Search Central: Mudanças de site com alteração de URLs](https://developers.google.com/search/docs/crawling-indexing/site-move-with-url-changes) · developers.google.com [Nicolás Cerón](https://dardo.studio/pt/estudio/) Nicolás Cerón é o fundador da Dardo, um estúdio de marca, design e desenvolvimento web em Bogotá, na Colômbia. ## Artigos relacionados - [**WordPress ou site sob medida? Como escolher e quando cada um compensa**WordPress ou site sob medida: quando cada um compensa e o meio-termo do WordPress headless, comparados em custo, velocidade, atualizações e propriedade.](https://dardo.studio/pt/blog/wordpress-ou-site-sob-medida/) - [**Migrar de Webflow para Astro: como mudar um site sem perder conteúdo, design nem posições no Google**Migrar de Webflow para Astro: a exportação deixa de fora CMS, formulários, busca e idiomas. O que tirar do Webflow, o que refazer no Astro e como manter o SEO.](https://dardo.studio/pt/blog/migrar-de-webflow-para-astro/) - [**Checklist de SEO para migração de site: troque de plataforma ou domínio sem perder posições**As posições raramente caem por causa da nova plataforma, e sim porque URLs que geravam tráfego deixaram de responder. Um checklist do inventário de URLs ao dia 90.](https://dardo.studio/pt/blog/checklist-seo-migracao-de-site/) - [**Quanto custa um site na Colômbia em 2026? Preços reais e o que muda um orçamento**Quanto custa um site na Colômbia: preços datados de fornecedores de Bogotá, custos anuais de domínio e hospedagem e o que realmente muda um orçamento.](https://dardo.studio/pt/blog/quanto-custa-um-site-colombia/) ## Continue explorando. - [Serviço · **Migração de site sem perder o SEO**](https://dardo.studio/pt/servicos/migracao-de-site/) - [Seu projeto · **Vamos conversar**](https://dardo.studio/pt/contato/)