DocumentaciónKCS de Experience Cloud

Configuración del atributo lang en los sitios de Edge Delivery de AEM

Última actualización: 22 de junio de 2026

Configure el atributo lang en HTML estático al crear sitios multilingües con AEM Universal Editor y Edge Delivery Services. Este método garantiza que el elemento de HTML incluya la configuración de idioma correcta para la SEO y la accesibilidad antes de que se ejecute JavaScript en el lado del cliente. Para solucionarlo, configure html-lang en los metadatos para que Edge Delivery Services procese el atributo lang correcto en el HTML estático.

Descripción description

Entorno

  • Adobe Experience Manager as a Cloud Service (AEMaaCS): sitios
  • Edge Delivery Services
  • Editor universal

Problema/Síntomas

  • La salida estática de HTML no incluye lang attribute en el elemento HTML.
  • Se hace difícil cumplir con los requisitos de SEO y accesibilidad para sitios en varios países o idiomas.

Resolución resolution

Para resolver este problema, siga estos pasos:

  1. Busque el archivo de definición de metadatos en el repositorio de Edge Delivery. Puede ser una hoja de cálculo como metadata.xlsx o un archivo CSV, o una hoja JSON expuesta como /metadata.json en el host .aem.page o .aem.live.
  2. Agregue asignaciones específicas de la configuración regional al archivo de metadatos y utilice patrones globales en la columna URL para hacer coincidir rutas específicas de la configuración regional, por ejemplo /it-it/<b> para páginas en italiano.
  3. Para cada asignación, especifique el código de región de idioma apropiado en una propiedad de html-lang que coincida con la estructura de la dirección URL, como it-IT para /it-it/.
  4. Confirme e inserte los cambios en la rama utilizada por el sitio de Edge Delivery Services.
  5. Vuelva a publicar al menos una página de muestra en cada configuración regional desde AEM o el editor universal para que se tengan en cuenta los metadatos actualizados.
  6. Abra la URL de Edge Delivery Services correspondiente (.aem.page o .aem.live) para una página de configuración regional de ejemplo.
  7. Use Ver página Source para confirmar que el elemento HTML incluye el elemento correcto lang attribute. . Si el resultado correcto aparece en Edge Delivery Services pero no en el dominio de producción, borre la caché de CDN o compruebe que la asignación de dominios apunta a la rama o al host actualizado.

### Notas

  • - Para la mayoría de los sitios en varios países o idiomas, se recomienda administrar html-lang mediante metadatos masivos por motivos de simplicidad y solidez. Puede obtener un control más granular por página agregando el campo HTML-lang a los metadatos de página individuales en el Editor universal. Sin embargo, este valor debe mostrarse como html-lang en los metadatos para que Edge Delivery Services lo procese correctamente.
recommendation-more-help
experience-cloud-kcs-help-kbarticles