Cómo migrar de WordPress a Next.js sin perder SEO
Publicado
Migrar de WordPress a Next.js puede dejarte un sitio más rápido y sin plugins que mantener, pero el posicionamiento no se muda solo. Lo que Google ya conoce son tus URLs, tus títulos y tus enlaces internos; si cambian sin plan, el tráfico cae. Esta guía recorre el orden en que conviene hacerlo para que no pase.
Antes de empezar: ¿de verdad necesitas migrar?
WordPress sigue siendo una buena opción cuando un equipo editorial publica a diario y depende de su editor visual. La migración tiene sentido cuando el esfuerzo se va en otra parte: actualizaciones de seguridad de plugins, un sitio lento que ningún plugin de caché termina de arreglar, o funciones a medida que el tema no soporta.
Si el problema es solo un tema pesado, cambiarlo puede ser suficiente. Si el problema es la plataforma, sigue leyendo.
Elige el camino: WordPress headless o migración completa
Hay dos formas de llegar a Next.js, y la decisión cambia todo lo que sigue.
- WordPress headless: WordPress se queda como gestor de contenido y Next.js lee las entradas por la REST API (/wp-json/wp/v2/posts) o con el plugin WPGraphQL. El equipo sigue escribiendo igual, pero sigues manteniendo y actualizando WordPress.
- Migración completa: el contenido pasa a archivos Markdown o MDX en el repositorio, o a otro gestor de contenido, y WordPress se apaga. Desaparece el mantenimiento de WordPress, pero cambia la forma de publicar.
Paso 1: haz el inventario de todas las URLs
Antes de escribir código, lista cada URL que hoy existe. Es la base de todo lo demás y la parte que más se salta.
Guárdalo en una hoja con tres columnas: URL vieja, URL nueva y decisión (mantener, redirigir o eliminar). Esa hoja se convierte después en tus redirecciones y en tu lista de pruebas.
- El sitemap de WordPress: /wp-sitemap.xml desde la versión 5.5, o /sitemap_index.xml si usas Yoast SEO.
- El informe de Rendimiento de Search Console, para saber qué páginas traen clics y no pueden fallar.
- Un rastreo del sitio con un crawler, para encontrar lo que el sitemap no lista.
- Lo que suele olvidarse: categorías, etiquetas, páginas de autor, paginación, adjuntos y las imágenes en /wp-content/uploads/.
Paso 2: conserva las URLs o redirige cada una
Lo mejor es que las URLs no cambien. Si tienen que cambiar, cada URL vieja debe redirigir de forma permanente a su equivalente más cercana. Redirigir todo a la página de inicio es un error común: Google puede tratar esas redirecciones como soft 404 y no traspasar sus señales.
En Next.js las redirecciones van en next.config. Con permanent: true, Next.js responde 308, que Google trata como permanente igual que un 301. Mantenlas al menos un año, que es lo que recomienda Google para los cambios de sitio.
Revisa también la barra final: las URLs de WordPress suelen terminar en barra y Next.js por defecto no. Si quieres conservarlas tal cual, activa trailingSlash: true y evitarás una redirección extra en cada página.
// next.config.mjs
const nextConfig = {
async redirects() {
return [
// Date-based WordPress permalinks to the new blog route
{ source: '/:year(\\d{4})/:month(\\d{2})/:slug', destination: '/blog/:slug', permanent: true },
// A renamed page, one to one
{ source: '/quienes-somos', destination: '/nosotros', permanent: true },
]
},
}
export default nextConfigPaso 3: lleva los metadatos página por página
Los títulos y descripciones que escribiste en Yoast o Rank Math son parte de lo que posiciona. Expórtalos y asígnalos a cada página nueva; no los regeneres a partir del título de la entrada.
Con el App Router, cada ruta define su título, descripción, canonical y Open Graph en generateMetadata. Configura metadataBase en el layout raíz para que las URLs relativas se conviertan en absolutas.
Los plugins de SEO también generaban datos estructurados (JSON-LD) sin que lo vieras: artículo, migas de pan, organización. Si no los recreas, se pierden.
// app/blog/[slug]/page.tsx
export async function generateMetadata({ params }) {
const { slug } = await params
const post = await getPost(slug)
return {
title: post.seoTitle,
description: post.seoDescription,
alternates: { canonical: `/blog/${post.slug}` },
openGraph: { title: post.seoTitle, images: [post.image] },
}
}Paso 4: imágenes, sitemap y robots
Las imágenes viven en /wp-content/uploads/ y pueden tener tráfico propio desde Google Imágenes. Copia esa carpeta con la misma ruta o redirige cada imagen, y conserva el texto alternativo.
Genera el sitemap y el robots.txt desde Next.js (app/sitemap.ts y app/robots.ts) para que se actualicen solos con cada página nueva. Antes del lanzamiento, comprueba que el robots.txt de producción no sea el del entorno de pruebas, que suele bloquear todo el sitio.
Paso 5: lo que WordPress hacía sin que lo vieras
Un sitio de WordPress resuelve varias cosas con plugins que en Next.js tienes que decidir de forma explícita:
- Formularios (por ejemplo Contact Form 7): pasan a una ruta de API o a un servicio de formularios.
- El feed RSS en /feed/: genéralo de nuevo si alguien lo consume, o redirígelo.
- Comentarios, búsqueda interna y páginas de autor o de etiqueta: decide si se migran, se redirigen o desaparecen.
- /wp-admin y /wp-login.php: pueden responder 404; no necesitan redirección.
Paso 6: lanza y vigila Search Console
Antes de cambiar el DNS, prueba todas las URLs de tu inventario contra el sitio nuevo. Cada una debe responder 200 si se conserva, o una redirección permanente que termine en una página con 200.
Después del lanzamiento, envía el sitemap nuevo en Search Console, inspecciona las páginas que más tráfico traían y revisa durante varias semanas los informes de Indexación de páginas y Rendimiento. Google advierte que durante una migración es normal ver fluctuaciones; lo que importa es que las páginas importantes vuelvan a indexarse con su nueva URL.
# old-urls.txt: one old URL per line, taken from the inventory
while read -r url; do
curl -s -o /dev/null -w "%{http_code} %{redirect_url} $url\n" "$url"
done < old-urls.txtLista de verificación
Si solo te quedas con una parte, que sea esta:
- Inventario completo de URLs, con la decisión para cada una.
- Redirecciones permanentes una a una, nunca todas a la página de inicio.
- Barra final consistente con las URLs que Google ya conoce.
- Títulos, descripciones, canonical y JSON-LD migrados página por página.
- Imágenes de /wp-content/uploads/ con la misma ruta o redirigidas.
- robots.txt de producción revisado antes del lanzamiento.
- Sitemap nuevo enviado y seguimiento en Search Console durante semanas.