DocumentaçãoKCS da Experience Cloud

Configurar o atributo lang nos sites do AEM Edge Delivery

Última atualização: 21 de junho de 2026

Configure o atributo lang no HTML estático ao criar sites multilíngues com o AEM Universal Editor e o Edge Delivery Services. Essa abordagem garante que o elemento do HTML inclua a configuração de idioma correta para SEO e acessibilidade antes que o JavaScript do lado do cliente seja executado. Para corrigir isso, configure html-lang nos metadados para que o Edge Delivery Services renderize o atributo lang correto no HTML estático.

Descrição description

Ambiente

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

Problema/Sintomas

  • A saída estática do HTML não inclui um lang attribute no elemento HTML.
  • Fica difícil atender aos requisitos de SEO e acessibilidade para sites de vários países ou vários idiomas.

Resolução resolution

Para resolver esse problema, siga estas etapas:

  1. Localize o arquivo de definição de metadados no repositório do Edge Delivery. Pode ser uma planilha, como metadata.xlsx, um arquivo CSV ou uma planilha JSON exposta como /metadata.json no host .aem.page ou .aem.live.
  2. Adicione mapeamentos específicos da localidade ao arquivo de metadados e use padrões globais na coluna de URL para corresponder a caminhos específicos da localidade, por exemplo /it-it/<b> para páginas italianas.
  3. Para cada mapeamento, especifique o código de região de idioma apropriado em uma propriedade html-lang que corresponda à sua estrutura de URL, como it-IT para /it-it/.
  4. Confirme e envie as alterações para a ramificação usada pelo site do Edge Delivery Services.
  5. Republicar pelo menos uma página de exemplo em cada localidade do AEM ou do Universal Editor para que os metadados atualizados sejam considerados.
  6. Abra a URL do Edge Delivery Services correspondente (.aem.page ou .aem.live) para uma página de localidade de exemplo.
  7. Use a Exibir Página Source para confirmar se o elemento HTML inclui a lang attribute correta. . Se o resultado correto for exibido no Edge Delivery Services, mas não no domínio de produção, limpe o cache da CDN ou verifique se o mapeamento de domínio aponta para a ramificação ou o host atualizado.

### Notas

  • - Para a maioria dos sites multipaíses ou em vários idiomas, recomenda-se o gerenciamento de html-lang por meio de metadados em massa para simplicidade e robustez. Você pode obter um controle mais granular por página adicionando um campo HTML-lang aos metadados de página individuais no Editor Universal. No entanto, esse valor ainda deve ser exibido como html-lang nos metadados para que o Edge Delivery Services o renderize corretamente.
recommendation-more-help
experience-cloud-kcs-help-kbarticles