AEM Dynamic Media: Images delivered as AVIF instead of requested format
This article explains how to resolve an issue where Adobe Experience Manager (AEM) Dynamic Media delivers images in AVIF format even when JPG or another format is requested.
Description description
Environment
- Adobe Experience Manager (AEM) Dynamic Media (Open APIs)
Symptoms
When publishing assets through AEM Dynamic Media, all image files are delivered as AVIF format, regardless of their original type (such as JPG or PNG). This occurs even when:
- The file extension is set to JPG in AEM Dynamic Media settings.
- The
fmt=jpgparameter is added to the asset delivery URL.
For example, a URL like:
https://example.com/adobe/assets/urn:aaid:aem:/as/.jpg?fmt=jpg
still results in the file being delivered as AVIF when saved from the browser. This can block workflows that require images in JPG format, such as integrations with email generation systems that do not support AVIF.
Cause
By default, AEM Dynamic Media’s SmartImaging feature automatically converts images to modern formats like AVIF or WebP to optimize delivery. Setting auto-format=false disables this behavior and preserves the requested image format.
Resolution resolution
Follow the steps below to resolve the issue:
- Review the asset delivery URL used for Dynamic Media images.
- To override automatic format conversion, append the parameter
auto-format=falseto the image URL. For example:
https://example.com/adobe/assets/urn:aaid:aem:/as/.jpg?auto-format=false
- Test the updated URL by accessing it in a browser or integration workflow. The image should now be delivered in the requested format (such as JPG) instead of AVIF.
- If using the images in an email client or external system, verify that the file is recognized as the correct format.
- For more details, refer to the AEM Dynamic Media Asset Delivery API documentation and search for the auto-format parameter.