DocumentaciónKCS de Experience Cloud

AEM Dynamic Media: la transparencia PNG se muestra como fondo blanco

Última actualización: 11 de agosto de 2026

En este artículo se describe cómo solucionar problemas en los que las imágenes PNG con fondos transparentes aparecen con un fondo blanco en lugar de con transparencia en Adobe Experience Manager Dynamic Media.

Descripción description

Entorno

Adobe Experience Manager (AEM) Dynamic Media (todas las versiones)

Síntomas

  • Las imágenes PNG con fondos transparentes se cargan en DAM y aparecen transparentes en las vistas previas de los recursos.
  • Cuando estas imágenes se utilizan en páginas web o se accede a ellas a través de direcciones URL de envío directo, la transparencia se sustituye por un fondo blanco.
  • El uso del parámetro fmt=png-alpha en la dirección URL de envío no resuelve el problema en algunos casos.
  • No se muestran mensajes de error; el problema es el procesamiento de imágenes.

Causa

De manera predeterminada, Dynamic Media devuelve imágenes con un fondo opaco a menos que se solicite explícitamente la transparencia mediante fmt=png-alpha. Si falta este parámetro o no se ha configurado correctamente, el fondo aparecerá en blanco.

Resolución resolution

Siga los pasos a continuación para resolver el problema:

  1. Compruebe que la dirección URL de entrega de imágenes incluye el parámetro fmt=png-alpha para solicitar explícitamente PNG con transparencia alfa.
  2. Si utiliza un ajuste preestablecido de imagen, confirme que el ajuste preestablecido está configurado para generar PNG con transparencia alfa. Si es necesario, actualice el ajuste preestablecido para incluir fmt=png-alpha.
  3. Después de actualizar las direcciones URL o los ajustes preestablecidos, borre la caché del explorador y cualquier caché de CDN para asegurarse de que se proporciona la imagen más reciente.
  4. Incruste la imagen en una página básica de HTML para confirmar que la transparencia se representa correctamente fuera de la interfaz de usuario de AEM. Si la transparencia se muestra correctamente aquí, el problema puede ser la configuración CSS o de fondo de la página.
  5. Revise la configuración de ImageServer. De forma predeterminada, si no se solicita la transparencia de forma explícita, ImageServer devuelve imágenes con un color de fondo opaco (el color predeterminado es el blanco). Actualice la solicitud o el ajuste preestablecido para garantizar que siempre se solicite transparencia para los recursos que la requieren.

Después de completar estos pasos, compruebe que la transparencia en PNG se muestra correctamente en las páginas web.

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