Migración de WordPress a un CMS headless: una guía práctica
Pasar a headless desacopla el contenido de WordPress del renderizado, de modo que puedes lanzar un front end rápido con Next.js mientras los editores conservan el panel de administración que conocen. Bien hecho, mantienes el posicionamiento y ganas velocidad. Hecho con descuido, indexas un sitio duplicado y pierdes tráfico el día del lanzamiento. Aquí tienes cómo hacerlo bien.
Ir a una sección8
- Qué significa realmente WordPress headless
- Decide primero: ¿realmente lo necesitas?
- API REST o WPGraphQL
- Exporta contenido y medios sin perder datos
- Preserva el SEO: la parte que determina el éxito
- QA previo al lanzamiento y la ventana de cambio
- Mantén el contenido fresco después del lanzamiento
- Presupuesto y dónde encaja Pineido
Qué significa realmente WordPress headless
El WordPress tradicional acopla contenido y presentación: los temas PHP extraen de la base de datos y renderizan HTML en cada solicitud. Headless separa esas responsabilidades. WordPress sigue gestionando el contenido (tus editores conservan el mismo panel de administración), pero en lugar de renderizar páginas expone el contenido mediante una API. Un front end independiente, casi siempre Next.js en 2026, obtiene ese contenido y renderiza el sitio público. La recompensa es real: las páginas estáticas o renderizadas en el edge cargan de forma habitual en menos de un segundo desde una CDN, y los datos agregados lo respaldan. El HTTP Archive Web Almanac encontró que solo alrededor del 40% de los sitios móviles de WordPress superan todas las Core Web Vitals, la cifra más baja entre las principales plataformas de CMS, mientras que los front ends headless bien construidos suelen superar el 90%. Pero la arquitectura habilita ese resultado, no lo garantiza. Un sitio headless mal construido que sobrehidrata componentes y envía un bundle de React de más de 500KB perderá frente a un sitio de WordPress tradicional bien cacheado siempre.
Decide primero: ¿realmente lo necesitas?
El consejo más honesto en todo este terreno es no migrar si no tienes un motivo. Si tu sitio de WordPress es lento, a menudo puedes arreglarlo por 50 dólares al mes con mejor hosting, WP Rocket o caché Nginx FastCGI, caché de objetos Redis y optimización de imágenes. Una construcción headless suele costar de 2 a 3 veces un proyecto de WordPress tradicional comparable, porque ahora mantienes una aplicación de front end independiente, infraestructura de despliegue y fontanería de SEO personalizada. Headless se gana su lugar cuando tienes necesidades de rendimiento exigentes con el presupuesto a la altura, cuando publicas en varios front ends (web, app, kiosco) desde una sola fuente de contenido, o cuando quieres una experiencia de desarrollo moderna basada en componentes que tu equipo mantendrá a largo plazo. Si tu sitio actual ya supera los 80 puntos en PageSpeed, arregla primero lo que tienes.
API REST o WPGraphQL
Esta es la bifurcación técnica central. La API REST viene con WordPress (desde la 4.7), no necesita plugin y te lleva aproximadamente el 80% del camino con la mitad de la complejidad. WPGraphQL es un plugin gratuito con más de 100.000 instalaciones activas que permite al front end solicitar exactamente los campos que necesita en una sola consulta, evitando el sobreabastecimiento al que es propenso REST. Para un sitio con mucho contenido y datos anidados (entradas, autores, términos y campos personalizados en una sola solicitud), WPGraphQL merece la dependencia añadida y la curva de aprendizaje. Si tu equipo no conoce GraphQL y la forma de los datos es simple, REST es el valor por defecto pragmático. En cualquier caso, si usas Advanced Custom Fields necesitas cableado adicional: los valores de ACF viven en wp_postmeta y no aparecen en REST sin habilitar la salida REST por grupo de campos, y los stacks de GraphQL necesitan tanto WPGraphQL como el plugin WPGraphQL for ACF.
Exporta contenido y medios sin perder datos
Aquí es donde las migraciones se rompen en silencio. La exportación XML estándar de WordPress estropea los medios porque las imágenes se almacenan como entradas cuyos IDs se regeneran al importar, de modo que los campos de imagen de ACF que referencian un ID antiguo acaban apuntando a la nada. El orden de operaciones fiable es medios primero: sube los activos a tu CDN o almacenamiento en la nube (S3, Cloudinary o el pipeline de activos de tu CMS) antes de importar el contenido, y luego reescribe las referencias de medios a las nuevas URLs durante la transformación. Para los datos de campos, tanto WP All Export Pro con el complemento de ACF como una exportación con script que recorra acf_get_field_groups() y vuelque a JSON funcionan; exporta las definiciones de los grupos de campos de ACF por separado mediante ACF > Tools. Reserva tiempo extra para el contenido de constructores: Elementor, Divi y WPBakery entrelazan contenido con marcado de maquetación en shortcodes y datos serializados, lo que resiste una extracción automatizada limpia. Trata las páginas construidas visualmente como trabajo de migración manual.
Preserva el SEO: la parte que determina el éxito
La mayor parte de la pérdida de posicionamiento en migraciones headless proviene de dos fallos. Primero, etiquetas meta y JSON-LD inyectados por JavaScript después de la carga. Puede que Google no los vea. La solución no es negociable: renderiza títulos meta, descripciones, canonicals, Open Graph y datos estructurados en la respuesta HTML real usando SSG, SSR o ISR, nunca solo del lado del cliente. Mantén Yoast o Rank Math como única fuente de verdad para esos metadatos y léelos a través de la API. Segundo, el origen de WordPress que sigue en marcha indexándose como duplicado. Bloquéalo: robots.txt bloquea todo excepto los endpoints REST y GraphQL, envía X-Robots-Tag: noindex en cada respuesta HTML del origen, y elimina o responde con 410 el sitemap del origen. La estrategia de URLs más segura es mantener las rutas idénticas (si /blog/my-post sigue siendo /blog/my-post, Google apenas lo nota). Donde las URLs deban cambiar, asigna cada una a un 301 en un CSV antes del lanzamiento y haz QA; un 301 bien configurado transfiere todo el PageRank.
QA previo al lanzamiento y la ventana de cambio
Rastrea tu sitio existente por completo con Screaming Frog, Sitebulb o Ahrefs antes de tocar nada, capturando archivos, páginas de etiquetas, series paginadas, páginas de autor y tipos de entrada personalizados, no solo las URLs obvias. Luego apunta el mismo rastreador al entorno de staging y busca 404, canonicals ausentes, enlaces internos rotos y códigos de estado incorrectos. Toma una muestra aleatoria de 50 URLs antiguas y confirma que cada una devuelve un 301 al destino correcto. Genera un único sitemap canónico desde el front end para que las URLs coincidan exactamente con el sitio público, y redirige con 301 el sitemap antiguo de WordPress hacia él. El cambio de DNS es el momento de mayor riesgo: apunta a ir del cambio a la validación completa en menos de cuatro horas, y luego reenvía el sitemap en Search Console de inmediato. Para sitios grandes, hazlo por fases. Migra el blog, valida durante 1 a 2 semanas, y luego mueve la siguiente sección para limitar el radio de impacto.
Mantén el contenido fresco después del lanzamiento
Las páginas estáticas son rápidas pero se quedan obsoletas, así que configura la revalidación bajo demanda en lugar de esperar reconstrucciones basadas en el tiempo. El patrón: un webhook de WordPress (el plugin WP Webhooks o un hook personalizado save_post) envía un POST a una ruta /api/revalidate de Next.js con un token secreto y la ruta o etiqueta afectada, de modo que solo se regeneran las páginas modificadas. La invalidación basada en etiquetas es más limpia cuando una edición afecta a muchas páginas. Una advertencia de hosting que golpea a los equipos: el ISR bajo demanda necesita un host que admita la API de revalidación de Next.js. Vercel lo hace de forma nativa; algunos hosts de WordPress gestionados y configuraciones multicontenedor de Docker o Kubernetes no, porque una llamada de revalidación solo alcanza un contenedor. Añade una caché de objetos Redis y una caché de respuestas de GraphQL del lado de WordPress para que las respuestas de la API no se recalculen en cada regeneración.
Presupuesto y dónde encaja Pineido
El hosting del front end es modesto al principio pero se mide por uso. Vercel Pro cuesta 20 dólares por asiento al mes con 20 dólares de crédito de uso, y los costes que sorprenden a la gente son el ancho de banda (facturado a 0,15 dólares/GB pasada la franquicia de 1TB de Pro), las solicitudes en el edge y las lecturas y escrituras de ISR. Configura alertas de gasto al 75% y al 100%. La partida mayor es la propia ingeniería de migración, que es exactamente el tipo de trabajo acotado y de alto riesgo que encaja en un sprint de alcance fijo. Pineido ejecuta migraciones de WordPress a headless como un sprint de precio fijo de 30 días por 8.500 dólares: exportación de contenido y medios con reescritura de referencias, un front end de Next.js sobre WPGraphQL o REST, SEO renderizado en el servidor, un mapa completo de redirecciones 301, bloqueo del origen y revalidación bajo demanda, con un diff de rastreo previo al lanzamiento para que veas que nada ha empeorado antes de cambiar el DNS.
¿Listo para lanzar?
Cuéntenos dónde está atascado. Lo revisaremos y le enviaremos una recomendación concreta en un día hábil.
Preguntas frecuentes
¿Perderé posiciones de SEO al pasar a headless?
No si la migración se hace correctamente. La pérdida de posicionamiento proviene de dos errores evitables: inyectar etiquetas meta y datos estructurados con JavaScript del lado del cliente en lugar de renderizarlos en el HTML, y dejar el origen antiguo de WordPress rastreable de modo que se indexe como duplicado. Renderiza todos los metadatos de SEO en el servidor, mantén las URLs idénticas donde sea posible (o asigna cada cambio a un 301), y aplica noindex más bloqueo de robots al origen. Las migraciones que preservan canonicals, redirecciones, sitemaps y datos estructurados suelen posicionarse igual o mejor después.
¿Debería usar la API REST de WordPress o WPGraphQL?
REST viene con WordPress, no necesita plugin y es el valor por defecto más simple para sitios con datos sencillos. WPGraphQL (un plugin gratuito con más de 100.000 instalaciones) permite al front end obtener exactamente los campos que necesita en una sola consulta, lo cual es mejor para sitios con mucho contenido y datos anidados como entradas, autores, términos y campos personalizados. Elige REST por simplicidad y WPGraphQL por precisión de consulta y rendimiento en modelos de contenido complejos.
¿Sobreviven mis Advanced Custom Fields a la migración?
Sí, pero necesitan un manejo extra. Los valores de ACF viven en wp_postmeta y no aparecen en la API REST a menos que habilites la salida REST por grupo de campos, y las configuraciones de GraphQL necesitan tanto WPGraphQL como WPGraphQL for ACF. Exporta las definiciones de los grupos de campos por separado mediante ACF > Tools, y exporta los datos reales de los campos con WP All Export Pro más el complemento de ACF o un script. Vigila especialmente los campos de imagen, ya que la exportación estándar de WordPress rompe las referencias de ID de medios.
¿Puede mi equipo seguir editando contenido en WordPress después de migrar?
Sí, ese es el principal atractivo de headless. WordPress sigue siendo el backend de contenido y los editores conservan la misma interfaz de administración, entradas, páginas y biblioteca de medios. El único cambio es que el contenido se publica en un front end de Next.js independiente a través de la API. Con la revalidación bajo demanda cableada mediante un webhook, las ediciones aparecen en el sitio en vivo en cuestión de segundos tras guardar, sin una reconstrucción completa ni un despliegue de un desarrollador.
¿Cuánto cuesta una migración de WordPress a headless?
Una construcción headless suele costar de 2 a 3 veces un proyecto de WordPress tradicional comparable, porque mantienes una aplicación de front end independiente, infraestructura de despliegue y fontanería de SEO personalizada. El hosting del front end comienza de forma modesta (Vercel Pro cuesta 20 dólares por asiento al mes, con ancho de banda y uso de ISR medidos por encima). Pineido ejecuta la migración en sí como un sprint de precio fijo de 30 días por 8.500 dólares, cubriendo la exportación, el front end de Next.js, el SEO renderizado en el servidor, las redirecciones y la revalidación.
¿Cuánto tarda una migración de WordPress a headless?
Un sitio de contenido típico tarda de 2 a 4 semanas: exportación de contenido y medios con reescritura de referencias, construcción del front end de Next.js, cableado del SEO del lado del servidor y la revalidación, y un rastreo previo al lanzamiento minucioso. Los sitios grandes o con mucho contenido de constructores tardan más, porque el contenido de Elementor, Divi y WPBakery resiste una extracción automatizada limpia y a menudo necesita migración manual. Los sitios con más de 5.000 entradas, contenido multilingüe o campos personalizados complejos son una clase de proyecto diferente y se benefician de un despliegue por fases, sección por sección.
Reciba ideas sobre operaciones cada semana
Únase a los responsables de empresas de servicios que reciben cada semana una idea práctica sobre operaciones, automatización y crecimiento.
Sin spam. Cancele cuando quiera.
¡Ya está suscrito! Busque nuestro próximo número en su bandeja de entrada.
No se pudo enviar. Inténtelo de nuevo o escriba a [email protected].