Después de enviar un sitio de staging a producción, Yoast SEO puede mantener el dominio de staging como URL canónica, o eliminar la canónica por completo. La solución es reconstruir los indexables de Yoast para que regenere cada canónica con tu dominio en producción, y establecer la canónica manualmente en cualquier página individual que siga siendo incorrecta.
¿Por qué las URLs canónicas de Yoast son incorrectas tras una migración del sitio?
Yoast SEO no calcula las URLs canónicas en cada carga de página. Las almacena en sus indexables: una caché de datos SEO guardada en la tabla de base de datos wp_yoast_indexable, más los valores por entrada en wp_postmeta. Cuando envías un sitio de staging a tu sitio de producción, esas filas viajan con la base de datos.
Si los indexables se crearon mientras el sitio todavía usaba el dominio de staging, contienen URLs de staging. Tras el push, verás uno de dos síntomas:
- La etiqueta
rel="canonical"apunta a la URL de staging (por ejemplohttps://staging.example.com/page/en lugar dehttps://example.com/page/). - La etiqueta canónica falta en algunas páginas, porque la fila del indexable almacenada está obsoleta o incompleta.
La causa son los datos de indexables en caché, no una instalación de Yoast defectuosa. Yoast emite automáticamente una canónica autorreferencial para cada entrada y página pública: no hay un interruptor global de activación/desactivación que cambiar. Así que el objetivo es hacer que Yoast reconstruya esa caché con el dominio correcto.
¿Cómo corrijo la URL canónica de una sola página en Yoast SEO?
Si solo una o unas pocas páginas están afectadas, sobrescribe la canónica directamente en el editor:
- Abre la página o entrada afectada en el editor de WordPress.
- En la barra lateral de Yoast SEO (o en la caja meta de Yoast debajo del contenido), abre la pestaña Avanzado.
- Localiza el campo URL canónica.
- Introduce la URL correcta de producción, o vacía el campo para que Yoast vuelva a su canónica autorreferencial predeterminada con tu dominio de producción.
- Actualiza la página.
Dejar el campo vacío suele ser la opción correcta: una canónica autorreferencial es lo que la mayoría de las páginas deberían tener. Introduce una URL explícita solo cuando la página deba apuntar a una canónica diferente (por ejemplo, una página sindicada o duplicada).
¿Cómo corrijo masivamente las URLs canónicas tras una migración completa del sitio?
Cuando muchas páginas llevan el dominio de staging, corregirlas una a una es poco práctico. En su lugar, reconstruye todos los indexables a la vez.
Opción 1: Restablecer y reoptimizar los datos SEO de Yoast
- Instala y activa el plugin Yoast Test Helper.
- Ve a Herramientas → Yoast Test.
- Haz clic en Reset Indexables & Migrations. Esto borra los indexables en caché para que Yoast los reconstruya desde cero.
- Ve a SEO → Herramientas y haz clic en Iniciar la optimización de datos SEO. Yoast regenera cada indexable —incluidas las URLs canónicas— con tu dominio actual (de producción).
- Desactiva el plugin Yoast Test Helper una vez que finalice la optimización; es una herramienta para desarrolladores, no está pensada para permanecer activa.
Opción 2: Reconstruir indexables con WP-CLI
Si tienes acceso a shell, la misma reconstrucción se ejecuta desde la línea de comandos:
wp yoast indexEsto reindexa todos los indexables de Yoast para el sitio actual. Es más rápido que el optimizador del navegador en sitios grandes y es seguro volver a ejecutarlo.
Tras cualquiera de las opciones, vacía toda la caché —tu plugin de caché, la caché del servidor y la CDN— para que los visitantes y los rastreadores reciban las etiquetas canónicas corregidas en lugar de una copia en caché de las antiguas.
Una cosa más que comprobar: confirma que se ejecutó una búsqueda y reemplazo en la base de datos durante el push, sustituyendo el dominio de staging por el dominio de producción. WP STAGING lo hace automáticamente cuando haces push, pero si importaste la base de datos de otra forma, un dominio de staging residual en los datos es la causa raíz que reconstruir los indexables por sí solo no resolverá.
¿Cómo evito problemas de URL canónica en el próximo push?
- Deja que WP STAGING gestione la reescritura del dominio. Cuando haces push con WP STAGING, ejecuta una búsqueda y reemplazo en toda la base de datos, incluidos los datos de Yoast. Evita las importaciones manuales de base de datos que se saltan este paso.
- Reconstruye los indexables después de cada push. Convierte "Reset Indexables & Migrations + optimización de datos SEO" (o
wp yoast index) en parte de tu lista de comprobación posterior al push. - Nunca codifiques manualmente una canónica por página al dominio de staging. Si estableciste una canónica explícita mientras probabas en staging, vacíala antes de hacer push para que la página de producción vuelva a una canónica autorreferencial.
Para conocer el trasfondo de por qué las etiquetas canónicas importan, consulta la guía de Google sobre consolidar URLs duplicadas y la explicación de Yoast sobre rel="canonical".
Preguntas frecuentes
¿Restablecer los indexables de Yoast eliminará mi configuración SEO?
No. Restablecer los indexables borra solo los datos SEO en caché. Yoast los reconstruye a partir de tus entradas y ajustes existentes, así que tus títulos, meta descripciones, palabras clave objetivo y configuración permanecen intactos.
¿Por qué mi URL canónica está vacía tras una migración?
Una canónica ausente casi siempre significa que la fila del indexable de la página está obsoleta o no se regeneró con el nuevo dominio. Reconstruir los indexables (Opción 1 o 2 anteriores) restaura la canónica autorreferencial.
¿Necesito el plugin Yoast Test Helper para solucionar esto?
Es la forma más sencilla de restablecer indexables y migraciones desde el administrador de WordPress. Si prefieres la línea de comandos, wp yoast index hace la reconstrucción sin ningún plugin adicional. En cualquier caso, el objetivo es el mismo: forzar a Yoast a regenerar sus datos SEO en caché.
¿Esto aplica tanto a Yoast SEO Free como a Premium?
Sí. Los indexables existen tanto en la versión gratuita como en la Premium de Yoast SEO, así que el mismo proceso de restablecer y reconstruir corrige las URLs canónicas en cualquiera de las dos.
