DocumentaçãoKCS da Experience Cloud

AEM Dynamic Media: a transparência de PNG é exibida como fundo branco

Última atualização: 11 de agosto de 2026

Este artigo descreve como resolver problemas em que imagens PNG com planos de fundo transparentes são exibidas com um plano de fundo branco em vez de transparência no Adobe Experience Manager Dynamic Media.

Descrição description

Ambiente

Adobe Experience Manager (AEM) Dynamic Media (todas as versões)

Sintomas

  • Imagens PNG com planos de fundo transparentes são carregadas no DAM e aparecem transparentes em visualizações de ativos.
  • Quando essas imagens são usadas em páginas da Web ou acessadas por meio de URLs de entrega direta, a transparência é substituída por um fundo branco.
  • O uso do parâmetro fmt=png-alpha na URL de entrega não resolve o problema em alguns casos.
  • Nenhuma mensagem de erro é exibida; o problema está na renderização da imagem.

Causa

Por padrão, o Dynamic Media retorna imagens com um plano de fundo opaco, a menos que a transparência seja explicitamente solicitada usando fmt=png-alpha. Se esse parâmetro estiver ausente ou não estiver configurado corretamente, o plano de fundo ficará branco.

Resolução resolution

Siga as etapas abaixo para resolver o problema:

  1. Verifique se a URL de entrega da imagem inclui o parâmetro fmt=png-alpha para solicitar explicitamente PNG com transparência alfa.
  2. Se estiver usando uma Predefinição de imagem, confirme se a predefinição está configurada para gerar arquivos PNG com transparência alfa. Atualize a predefinição, se necessário, para incluir fmt=png-alpha.
  3. Depois de atualizar URLs ou predefinições, limpe o cache do navegador e qualquer cache CDN para garantir que a imagem mais recente seja fornecida.
  4. Incorpore a imagem em uma página básica do HTML para confirmar se a transparência é renderizada corretamente fora da interface do usuário do AEM. Se a transparência for exibida corretamente aqui, o problema pode estar no CSS da página ou nas configurações do plano de fundo.
  5. Examine as configurações do ImageServer. Por padrão, se a transparência não for explicitamente solicitada, o ImageServer retornará imagens com uma cor de fundo opaca (o padrão é branco). Atualize a solicitação ou predefinição para garantir que a transparência seja sempre solicitada para ativos que a exigem.

Após concluir essas etapas, verifique se a transparência do PNG é exibida corretamente nas páginas da Web.

recommendation-more-help
experience-cloud-kcs-help-kbarticles