Migrar de WordPress a Astro requiere separar tres cosas: el contenido que quieres conservar, la presentación que vas a reconstruir y las funciones que hoy resuelven plugins. Antes de programar, decide quién editará la web después. Conserva dominio y rutas cuando sea posible y comprueba cada función antes de sustituir la web publicada.
Si tu WordPress va lento, migrar no es automáticamente la mejor solución. Un problema de imágenes, caché o alojamiento puede resolverse sin reconstruir toda la web. El cambio tiene sentido cuando responde a una necesidad que compensa su desarrollo y mantenimiento.
Esta guía explica ese recorrido con un inventario de funciones y un ejemplo de código para conservar las rutas. El ejemplo utiliza direcciones ficticias; no representa una migración de cliente ni una medición de mejoras de tráfico.
Cuándo compensa pasar de WordPress a Astro
Valoraría el cambio para una web de servicios o un blog donde se quiere controlar el frontend, reducir dependencias de un constructor visual y mantener una estructura definida. También cuando hay una persona o equipo que asumirá el código y la publicación.
Lo pensaría más si el negocio depende de WooCommerce, membresías, reservas, comentarios o varios plugins que funcionan juntos. Reconstruir esas funciones puede costar más que corregir el WordPress actual. Si el problema es un diseño anticuado, un rediseño dentro de WordPress también es una alternativa.
La comparativa entre Astro y WordPress desarrolla la elección de plataforma. Aquí parto de otra pregunta: qué hay que resolver para sustituir una web que ya existe.
Decide si WordPress desaparece o sigue como panel
Hay dos caminos distintos:
- Retirar WordPress. El contenido pasa a archivos o a otro CMS. Habrá que acordar cómo se editará y qué sustituye las funciones utilizadas.
- Conservar WordPress como CMS headless. El equipo sigue editando en su panel y Astro utiliza sus datos para construir la web pública. WordPress conserva su alojamiento, actualizaciones y permisos.
Astro documenta cómo conectarse a WordPress mediante su API. Conservar el panel no conserva automáticamente el tema, las vistas previas ni el comportamiento de los plugins en el frontend nuevo.
Si ese es el camino elegido, la guía Astro con WordPress headless incluye la conexión REST con TypeScript, paginación, generación de rutas y las decisiones de publicación y SEO que faltan en una prueba básica.
Si las páginas se generan durante el build, publicar en WordPress debe desencadenar una nueva generación de Astro. Si se consultan los datos en cada petición, habrá que mantener el servidor y esa dependencia. Un panel que dice “publicado” y una web que sigue mostrando lo anterior es un flujo incompleto.
Haz un inventario antes de exportar contenido
Empieza por una lista de URLs obtenida del sitemap, el rastreo, Search Console y el propio WordPress. Ninguna de esas fuentes por separado garantiza recogerlo todo. Añade páginas de campañas, documentos y rutas que reciban enlaces aunque no aparezcan en el menú.
Para cada página, apunta su destino, contenido, función y comprobación pendiente. Este ejemplo de inventario muestra decisiones diferentes:
| URL actual | Decisión y prueba necesaria |
|---|---|
/servicios/consulta/ |
Conservar la ruta y revisar contenido, CTA y metadatos. |
/blog/primera-consulta/ |
Conservar la ruta, fecha original, enlaces e imagen. |
/reservar/ |
Identificar quién procesa y confirma la reserva antes de reconstruir la interfaz. |
/wp-content/uploads/guia.pdf |
Mantener el recurso o preparar su nueva ubicación y redirección. |
Incluye formularios, buscador, cookies, analítica, traducciones y correo asociado al dominio. Cambiar la web no debería modificar registros de correo por accidente. Anota también quién controla dominio, DNS, hosting y cuentas externas.
Qué puedes conservar y qué tienes que reconstruir
Exportar contenido y reconstruir una web son trabajos diferentes. El tema y los plugins pueden estar produciendo partes que no aparecen como un campo de texto.
| Pieza de WordPress | Qué resolver en Astro |
|---|---|
| Entradas y páginas | Importar textos, fechas, autores y relaciones; revisar el resultado renderizado. |
| Biblioteca de medios | Copiar archivos, actualizar referencias y conservar información útil como el alt. |
| Tema o Elementor | Reconstruir componentes, estilos, responsive e interacciones. Su diseño no se convierte por importar entradas. |
| Shortcodes y bloques de plugins | Detectar cada tipo y sustituirlo por contenido o componentes equivalentes. |
| Plugin SEO | Extraer los datos necesarios y generar title, description, canonical, schema y sitemap en el sistema nuevo. |
| Formulario | Conectar envío, validación, protección frente a abuso y confirmación; comprobar la recepción real. |
| Buscador, comentarios o reservas | Elegir una implementación o servicio concreto, con coste y responsable. |
| Redirecciones e idiomas | Trasladar reglas y relaciones entre URLs al alojamiento y las rutas nuevas. |
Un formulario que se ve igual pero no envía es una función perdida. Un shortcode que aparece como texto en una entrada también. Estas comprobaciones deben formar parte del alcance, no quedar para después de publicar.
Extrae los datos sin confundir una respuesta con una copia completa
La REST API ofrece endpoints separados para entradas, páginas y medios. Este comando ilustra la extracción de una página de entradas públicas; cambia el dominio por uno que administres:
curl --fail --show-error \
'https://example.com/wp-json/wp/v2/posts?per_page=100&page=1' \
--output posts-page-1.jsonLa documentación de WordPress sobre paginación explica los límites y las cabeceras para continuar. Repite la extracción hasta completar las páginas disponibles y contrasta el número de registros. Ese archivo no contiene por sí solo las páginas, todos los medios, borradores ni la configuración del sitio.
Haz antes una copia recuperable de la instalación y su base de datos. Una exportación de contenido sirve para trasladar información; no sustituye una copia con la que restaurar el servicio.
Si el objetivo final es Markdown o MDX, el HTML necesita conversión y revisión. Los constructores visuales y bloques personalizados pueden requerir trabajo manual. La guía de migración de Astro recoge alternativas para empezar, pero no convierte cualquier instalación en una web terminada.
Cómo conservar las rutas de las páginas
Un registro de WordPress puede tener consulta como slug y /servicios/consulta/ como ruta completa. Si construyes la dirección nueva solo con el slug, perderás la jerarquía anterior.
Este extracto de src/pages/[...path].astro genera las rutas a partir de link. El archivo src/data/wordpress.json representa los registros ya extraídos y revisados. https://example.test es el dominio ficticio del ejemplo; habría que adaptarlo al origen real:
---
import records from '../data/wordpress.json';
export function getStaticPaths() {
return records.map((record) => {
const url = new URL(record.link);
if (url.origin !== 'https://example.test' || url.search || url.hash) {
throw new Error(`Review the source URL: ${record.link}`);
}
return {
params: { path: url.pathname.replace(/^\/+|\/+$/g, '') },
props: { record },
};
});
}
---Usar el pathname completo conserva prefijos como /blog/ y /servicios/. Después del build, comprueba que cada ruta esperada existe y que sus enlaces y recursos apuntan a destinos válidos. Este fragmento resuelve la generación de rutas; las plantillas y los metadatos requieren su propia implementación.
Si utilizas set:html para mostrar el cuerpo importado, recuerda que esa directiva no sanea contenido externo. Valida y sanea HTML y URLs antes de publicarlos. Resolver las rutas tampoco convierte Elementor ni sustituye las funciones de los plugins.
En mi portfolio, la arquitectura multipágina con Astro muestra cómo organizo contenido, componentes y metadatos. Es una prueba de implementación del destino, no un antecedente de migración desde WordPress.
Revisa URLs, metadatos y recursos antes del cambio
Conserva las URLs que siguen teniendo sentido. Cambiar de tecnología no obliga a cambiar dominio ni todas las rutas. Cuando una dirección deba cambiar, registra su equivalente y configura una redirección permanente en el alojamiento que recibirá la petición antigua.
Si retiras WordPress, sus plugins de redirección dejarán de resolver las peticiones que ya no lleguen a esa instalación. Comprueba las reglas en el destino real. Evita enviar todas las páginas antiguas a la portada sin una equivalencia útil.
Para cada tipo de página compara título, descripción, canonical, idioma, contenido, enlaces y medios. Revisa también páginas de categorías y autores antes de eliminarlas. Un export de entradas puede omitir datos SEO guardados por plugins; habrá que extraerlos por separado o definirlos de nuevo con criterio.
Google recomienda preparar un mapa de URLs y comprobar el traslado; también advierte de fluctuaciones cuando cambian las direcciones. Por eso no prometería una migración “sin perder posiciones”. Guía de Google para cambios de URL.
Publica con una comprobación y una vuelta atrás preparadas
Antes del cambio, deja por escrito qué versión se publicará, qué contenido queda congelado y cómo se incorporarán las ediciones hechas durante el desarrollo. Si WordPress sigue activo como panel, prueba una publicación completa hasta verla en la URL pública.
Reserva una revisión del sitio final:
- Abrir páginas representativas en móvil y escritorio.
- Recorrer enlaces antiguos y comprobar su respuesta o destino.
- Enviar un formulario de prueba y confirmar su recepción.
- Revisar indexabilidad, sitemap, metadatos y analítica respetando el consentimiento.
- Guardar una referencia previa para comparar errores, visitas y consultas después.
Mantén una copia y un procedimiento para volver a la versión anterior. Restaurar el frontend no restaura automáticamente mensajes, pedidos o datos externos recibidos durante el cambio.
Si después alguna URL no aparece en Google, sigue un diagnóstico de indexación en lugar de atribuirlo directamente a Astro. Una web generada correctamente todavía necesita ser descubierta y evaluada.
Qué debería incluir un presupuesto de migración
Pide que se especifiquen páginas, tipos de contenido, funciones, medios, idiomas, redirecciones y edición posterior. Añade quién prepara los textos, quién valida la equivalencia y qué se considera terminado.
También deberían figurar las pruebas, el cambio de alojamiento, las cuentas o servicios que se siguen pagando y el soporte posterior acordado. Migrar diez páginas de texto tiene un alcance diferente de reconstruir reservas, un catálogo o un sistema de usuarios, aunque el número de URLs sea parecido.
El objetivo es saber qué vas a conservar y cómo funcionará la web después. Si estás valorando esa reconstrucción, consulta mi servicio de diseño y desarrollo web personalizado para definir el alcance antes de elegir la solución.