Migra de WordPress a Astro en Madrid
Muchas empresas en Madrid usan WordPress pero enfrentan límites de rendimiento, sobrecarga de seguridad y costes de hosting crecientes. Astro resuelve esto con HTML estático, cero JavaScript por defecto y despliegue en el edge. Migro sitios WordPress existentes a Astro con preservación SEO completa, mapeo de URLs y redirecciones 301.
- PageSpeed 95-100
HTML estático sin JavaScript. Más rápido que cualquier solución WordPress.
- Migración SEO segura
Mapeo de URLs, redirecciones 301, posiciones en Google preservadas.
- Hosting en Cloudflare Pages
CDN global, SSL gratuito, despliegues instantáneos. Costes de hosting cercanos a cero.
Tu empresa está en Madrid, la web está en español y la quieres ver en Google España, pero también en México, Colombia o Argentina. Ahí empiezan las preguntas técnicas: qué código de idioma va en cada página, si existe un código para “toda Latinoamérica”, cómo se construye el sitemap y qué URL debe declararse como canónica. Me llamo Mariusz Szatkowski, programo para la web desde 2006 y trabajo en remoto y por escrito desde Gdynia, en Polonia. Aquí explico cómo resuelvo esas tres piezas en una web hecha con Astro, citando siempre la documentación de Google y de Astro.
Un idioma, varios países
Una web multilingüe y una web multirregional no son lo mismo. Google las distingue en su guía sobre sitios multirregionales y multilingües: la primera ofrece contenido en más de un idioma y Google intenta servir la página en el idioma de quien busca; la segunda se dirige de forma explícita a usuarios de distintos países, y Google intenta mostrar la versión local adecuada.
Una empresa madrileña que vende en español a varios mercados tiene sobre todo el segundo problema. El idioma es el mismo, pero cambian los plazos de envío, las condiciones, la forma de contactar o la normativa que menciona la página. El trabajo técnico consiste en decir a Google qué versión corresponde a cada público sin que las versiones compitan entre sí.

Foto: Diego Delso, CC BY-SA 4.0, Wikimedia Commons.
Por qué es-419 no sirve en el hreflang
El código es-419 existe. En el registro de subetiquetas de idioma de IANA, la región 419 corresponde a “Latin America and the Caribbean” y figura desde el 16 de octubre de 2005. Viene de la clasificación M49 de Naciones Unidas, que usa el mismo número para esa región (UNSD, M49).
Google, sin embargo, no lo acepta en el hreflang. Su guía sobre versiones localizadas de una página dice que el primer código es el idioma en formato ISO 639-1 y el segundo, opcional, la región en formato ISO 3166-1 alfa-2, y añade que los códigos fuera de esas normas, “such as es-419”, no están admitidos. La misma página advierte que los códigos reservados para otra cosa, como EU o UN, se ignoran.
La herramienta de Astro tampoco lo deja pasar. En la integración @astrojs/sitemap, el valor de cada idioma dentro de la opción i18n solo admite letras del alfabeto inglés y guion. Un es-419 falla en la validación de la configuración antes de llegar a ningún buscador.
La alternativa tiene dos formas, y las dos están en la guía de Google:
- Códigos por país:
es-MX,es-AR,es-CO. Varios códigos pueden apuntar a la misma URL si la versión latinoamericana es una sola. - El idioma sin región:
essirve como versión para cualquier hispanohablante sin país asignado. Google recomienda ese comodín cuando tienes varias URL en el mismo idioma para distintos países, y precisa que puede ser una de las páginas específicas.
es-ES, es y x-default: tres decisiones distintas
Estos tres valores se confunden a menudo, y cada uno responde a una pregunta diferente.
| Valor | Para quién | Cuándo lo uso |
|---|---|---|
es-ES | Usuarios en España que leen español | Cuando la versión española tiene algo propio: envíos peninsulares, IVA, referencias a la normativa española |
es | Cualquier hispanohablante sin versión de país | Como comodín; puede ser la misma URL que es-ES o una versión neutra |
es-MX, es-AR | Usuarios de ese país | Solo si existe una versión con contenido distinto para ese mercado |
x-default | Idiomas que la web no cubre | Para un selector de idioma o la portada; Google dice que se diseñó para selectores |
Hay dos errores que veo con frecuencia. El primero es usar solo el país: hreflang="mx" no significa México, porque el primer código siempre es el idioma, y Google no deduce el idioma a partir del país. El segundo es la grafía: Google acepta mayúsculas y minúsculas, pero escribir la región en mayúsculas (es-ES) sigue la convención de ISO 3166-1 y facilita la revisión.
Reciprocidad, URL absolutas y un solo método
La guía de Google fija tres reglas que aplico en todas las versiones:
- Cada versión se nombra a sí misma y a todas las demás. Si la página de España enlaza a la de México y la de México no devuelve el enlace, Google ignora las etiquetas. La guía explica el motivo: así nadie de otro sitio puede declararse versión alternativa de tus páginas.
- Las URL son completas.
https://example.com/mx/servicios/, nunca/mx/servicios/ni//example.com/mx/servicios/. - Un solo método. Las etiquetas pueden ir en el
<head>del HTML, en cabeceras HTTP o en el sitemap. Google las considera equivalentes y dice que usar las tres no aporta nada en la Búsqueda y complica el mantenimiento.
En el HTML, las etiquetas deben estar dentro de un <head> bien formado, y Google pide no mezclar en un mismo <link> el hreflang con otros atributos como media.
Estructura de URL: dominio .es, carpetas o subdominios
El dominio .es es el de primer nivel de España. Lo gestiona Dominios.es, la unidad de la entidad pública Red.es encargada del registro bajo ese código de país (Dominios.es), con dirección postal en la Plaza Manuel Gómez Moreno, en Madrid (contacto de Dominios.es).
La tabla de Google sobre estructuras de URL resume las ventajas de cada opción:
- Dominio de país (
example.es): orientación geográfica clara, pero más infraestructura y un solo país por dominio. - Subdominio (
mx.example.com): fácil de montar, aunque el usuario quizá no sepa simxindica idioma o país. - Subdirectorio (
example.com/mx/): fácil de montar y de bajo mantenimiento, porque comparte alojamiento.
Si vendes sobre todo en España, un dominio .es es una elección razonable. Si vendes en España y fuera, suelo proponer un dominio con carpetas por versión, porque Astro organiza el enrutado precisamente así.
Google añade dos avisos que afectan al diseño de la web. No conviene redirigir automáticamente de una versión de idioma a otra según lo que supongas del usuario, y no conviene adaptar el contenido por la IP. La razón es práctica: Googlebot suele rastrear desde Estados Unidos y envía las peticiones sin cabecera Accept-Language, así que una web que redirige por idioma puede esconder versiones al rastreador. En su lugar, cada página lleva enlaces visibles a sus otras versiones.
La configuración de Astro para España y otros países
La guía de internacionalización de Astro define los idiomas en astro.config.mjs. Cada idioma corresponde a una carpeta en src/pages/, y con prefixDefaultLocale: false, el valor por defecto, el idioma principal va sin prefijo. Un idioma también puede declararse como objeto con path, que fija la carpeta y la URL, y codes, la lista de códigos que el navegador reconoce:
// astro.config.mjs
import { defineConfig } from "astro/config";
import sitemap from "@astrojs/sitemap";
export default defineConfig({
site: "https://example.com",
i18n: {
locales: ["es", { path: "mx", codes: ["es-MX"] }, "en"],
defaultLocale: "es",
},
integrations: [
sitemap({
i18n: {
defaultLocale: "es",
locales: { es: "es-ES", mx: "es-MX", en: "en" },
},
}),
],
});La opción site no es decorativa. La referencia de configuración dice que Astro usa esa URL completa para generar el sitemap y las URL canónicas, y la integración del sitemap no funciona sin ella.
Astro también ofrece Astro.preferredLocale, que cruza la cabecera Accept-Language del navegador con tus idiomas, pero solo en páginas renderizadas bajo demanda. Lo uso para sugerir otra versión con un aviso, no para redirigir, por lo que explica Google en el apartado anterior.
El sitemap con @astrojs/sitemap: qué hace y qué no
Al compilar, la integración escribe sitemap-index.xml y sitemap-0.xml. Con la opción i18n añade a cada URL sus alternativas como <xhtml:link>. Hay tres límites que conviene conocer antes de confiar en ella.
Empareja por ruta, no por traducción. El código de la integración quita el prefijo de idioma y agrupa las URL cuya ruta restante coincide. /servicios/ y /mx/servicios/ quedan enlazadas; /servicios/ y /en/services/ no. Si traduces los slugs, las alternativas hay que construirlas tú, con la función serialize y el campo links de cada entrada, o con etiquetas en el HTML.
No mira la canónica. El mismo archivo tiene un comentario pendiente sobre respetar las URL de rel="canonical". Si una página declara como canónica otra URL, la integración la incluye igualmente, así que la excluyo con filter(). Google pide no indicar una URL en el sitemap y otra distinta en la canónica para la misma página (guía de canónicas).
No añade x-default. Los enlaces alternativos salen solo de los idiomas que configuras. Si necesitas x-default, va en el HTML o mediante serialize.
Sobre el resto del archivo, la guía de Google para crear sitemaps es concreta. Un sitemap admite como máximo 50.000 URL o 50 MB sin comprimir; la integración de Astro divide por defecto en archivos de 45.000 entradas (entryLimit). Google ignora <priority> y <changefreq>. Usa <lastmod> solo si es exacto de forma constante y verificable, y debe reflejar un cambio significativo, como el contenido principal, los datos estructurados o los enlaces, no el año del pie de página. Como la opción lastmod de la integración vale para todo el sitio, prefiero no ponerla o asignarla página a página con serialize a partir de la fecha real de cada entrada. Por último, una línea Sitemap: en robots.txt indica dónde está el índice.
Canónicas que no contradicen al hreflang
La guía de Google sobre canónicas trae varias reglas que, en una web con versiones por país, se traducen en estas decisiones:
- Canónica propia en cada página. Google pide incluir
rel="canonical"también en la página canónica. Cada versión, la de España y la de México, se declara a sí misma. - El mismo idioma. Si usas hreflang, la canónica debe estar en el mismo idioma o en el mejor sustituto disponible.
- Ni robots.txt ni noindex para elegir canónica. Google desaconseja las dos cosas: una URL bloqueada en
robots.txtpuede indexarse igualmente sin su contenido, ynoindexsaca la página de la Búsqueda. - Enlaces internos a la URL canónica. El menú, las migas y el pie apuntan a la misma forma de URL que declara la canónica.
La forma de la URL importa. La opción trailingSlash de Astro vale 'ignore' por defecto, y la referencia de configuración advierte que en las páginas prerenderizadas la barra final la gestiona el alojamiento. Por eso compruebo en el despliegue real que /servicios y /servicios/ no sirven dos páginas distintas, y que la canónica, el sitemap y los enlaces usan una sola forma.
En el HTML, una canónica a partir de site es una línea, y el hreflang sale de un mapa de traducciones que guardo junto al contenido:
---
// src/components/SeoLinks.astro
const { alternates } = Astro.props; // [{ hreflang: "es-ES", path: "/servicios/" }, ...]
---
<link rel="canonical" href={new URL(Astro.url.pathname, Astro.site).href} />
{alternates.map(({ hreflang, path }) => (
<link rel="alternate" hreflang={hreflang} href={new URL(path, Astro.site).href} />
))}Si tu web ya funciona con WordPress como gestor de contenidos y Astro solo en la parte pública, el reparto de sitemap y canónica entre los dos sistemas lo explico en el artículo sobre sitemap y canonical en WordPress headless.
Cómo trabajo un proyecto contigo
Todo el proceso es remoto y escrito, sin llamadas ni reuniones.
- Briefing: me envías la URL actual, los países a los que vendes y qué cambia en cada uno.
- Preguntas por escrito: antes de proponer nada, aclaro qué versiones hacen falta de verdad.
- Mapa de URL y códigos: recibes una tabla con cada versión, su carpeta, su código hreflang y su canónica.
- Alcance y supuestos por escrito: qué entra, qué queda fuera y qué aportas tú. Lo nuevo se valora aparte antes de hacerse.
- Entorno de pruebas: reviso en la versión compilada la reciprocidad del hreflang, el sitemap y las canónicas.
- Aceptación y publicación: validas el mapa de URL en pruebas y publico con la versión anterior guardada para volver atrás si algo falla.
- Después del lanzamiento: si quieres que vigile el hreflang y el sitemap cuando añadas países, lo contratamos como mantenimiento aparte.
Qué necesito de ti para empezar
- La URL de tu web y, si existe, el acceso al repositorio y al alojamiento.
- La lista de países y, para cada uno, qué cambia en el contenido.
- Los textos de cada versión, o quién los prepara; yo no traduzco ni redacto.
- Las maquetas o la hoja de cálculo con los elementos de cada vista; el diseño es tuyo.
- El acceso a Search Console, si ya tienes la propiedad creada.
Lista de comprobación antes de publicar
Puedes recorrerla tú mismo sobre la versión compilada, contrates o no conmigo.
| Comprobación | Dónde lo miro |
|---|---|
Ningún hreflang usa es-419, EU, UN ni un país sin idioma | HTML compilado o sitemap |
| Cada versión se nombra a sí misma y a todas las demás | Una página por plantilla, en todas las versiones |
Todas las URL alternativas son absolutas y con https | site en astro.config.mjs |
| El hreflang está en un solo método | HTML o sitemap, no los dos |
Hay x-default si existe selector de idioma | <head> de la portada |
| Cada página tiene canónica propia en su idioma | <link rel="canonical"> |
| El sitemap no incluye páginas con canónica ajena | filter() de la integración |
No hay <lastmod> con la fecha de compilación en todas las URL | Sitemap generado |
| Ninguna redirección automática por idioma o IP | Middleware y configuración del alojamiento |
robots.txt apunta al índice del sitemap | public/robots.txt |
Preguntas frecuentes
¿Puedo usar es-419 para toda Latinoamérica?
No en el hreflang. Google dice que solo admite regiones ISO 3166-1 alfa-2 y pone es-419 como ejemplo de código no admitido. Para una sola versión latinoamericana uso el código genérico es o códigos por país, como es-MX o es-AR, que apuntan a la misma URL.
¿Necesito una versión distinta para cada país?
Solo si el contenido cambia de verdad: envíos, condiciones, moneda, datos de contacto o normativa. Si el texto es el mismo, una versión es-ES y un es genérico suelen bastar. Lo decidimos por escrito antes de crear carpetas.
¿Pongo el hreflang en el HTML o en el sitemap?
En uno de los dos. Google considera equivalentes el HTML, las cabeceras HTTP y el sitemap, y dice que usar los tres a la vez no aporta nada en la Búsqueda. En Astro suelo elegir el HTML cuando los slugs están traducidos.
¿Puedo redirigir automáticamente según el idioma del navegador?
Google desaconseja redirigir automáticamente de una versión de idioma a otra. Además, Googlebot suele rastrear desde Estados Unidos y sin cabecera Accept-Language. Prefiero un enlace visible a las otras versiones.
¿Me conviene un dominio .es o una carpeta /es/?
Un dominio de país deja clara la orientación geográfica, pero según Google solo puede orientarse a un país. Si vendes en España y fuera, un dominio con carpetas por versión es más fácil de mantener.
¿Haces también los textos y el diseño?
No. El diseño gráfico, las maquetas y los textos de cada versión los aportas tú. Yo implemento la estructura, el enrutado, el hreflang, el sitemap y las canónicas, y te paso una hoja de cálculo para marcar qué va en cada vista.
Escríbeme con tu caso
Si tu web ya está en Astro, o quieres pasarla a Astro, y no tienes claro qué códigos, carpetas y canónicas necesita, escríbeme desde la página de contacto. Cuéntame la URL, los países a los que vendes, la tecnología actual y la fecha que te importa. Respondo por escrito en días laborables, y la primera valoración por escrito no tiene coste. Si prefieres leer antes cómo trabajo con Astro en general, está en la página de desarrollador Astro.
Proyectos seleccionados
Ejemplos de mi trabajo.
Sitio Web Corporativo: weglopex.pl
El sitio weglopex.pl fue creado como portal informativo moderno, dedicado a entusiastas y profesionales del sector energético, con enfoque particular en el carbón y la minería.
Sitio Web de Salud: fermentum-mobile.pl
El sitio web fermentum-mobile.pl es una plataforma dedicada creada para entusiastas de la fermentación que desean explorar métodos tradicionales de procesamiento y descubrir productos fermentados.
sprint.pl - Proyecto WordPress | WPPoland
Sprint.pl es un sitio web creado para Sprint S.A., una empresa de Olsztyn que opera desde 1988 como integrador de sistemas y proveedor de software avanzado.
Soporte y desarrollo WordPress en Madrid
¿Buscas el servicio: Desarrollador Astro en Madrid?
Describe tu proyecto por e-mail. Respondo en 48 horas.
Describe tu proyectoExplora otros servicios WordPress y base de conocimiento
Migración a Astro, Next.js y headless WordPress.
Sincronización WooCommerce con ERP y mayorista.
Automatización de procesos de negocio en torno a WordPress y sistemas empresariales.
Biblioteca de casos concretos de automatización.
Headless WordPress, Sanity, Strapi y Contentful con Astro o Next.js.
Astro, MDX, edge delivery y Core Web Vitals medidos con tráfico real.
Ingeniería WordPress y arquitectura personalizada.
Arquitectura headless, ERP e IA escalable para enterprise.
Categorías relacionadas
Artículos de apoyo

De seis a dieciséis semanas para proyectos típicos, en cuatro fases: descubrimiento, alcance, construcción y cutover, ajuste. Las variables son el tamaño del catálogo, el número de integraciones, la preservación de URLs y la disposición del equipo editorial, no la elección del framework.

Análisis exhaustivo del coste total de propiedad (TCO) a 4 años, métricas reales de Core Web Vitals, arquitectura Astro 7 GraphQL APQ y matriz de decisión de 10 puntos para directores de tecnología que eligen entre WordPress desacoplado y tradicional.

La decisión entre Shopify Plus y WooCommerce headless en 2026 ya no es un compromiso binario "plataforma vs personalizado". Ambos pueden funcionar en headless, ambos integran IA, ambos sirven en el edge. Los ejes reales son el control, el coste total a lo largo de cinco años y la estrategia de salida. Este artículo recorre la matriz con datos confirmados de cada plataforma.