Dynamic Media image renditions show white space, incorrect aspect ratios, or missing zoom behavior
Dynamic Media image renditions display white padding, incorrect aspect ratios, missing zoom behavior, or blurry output when image preset settings don’t align with the requested image dimensions. Update the image preset configuration or apply appropriate Dynamic Media fit and scaling parameters to deliver the expected image output.
Description description
Environment
- Adobe Experience Manager as a Cloud Service
- AEM Dynamic Media
- Dynamic Media Image Presets
- Asset Delivery APIs
Issue/Symptoms
- Images display white padding on one or more sides in Dynamic Media renditions.
- Images don’t upscale when requested dimensions exceed the original asset size.
- Rendition previews display incorrect aspect ratios compared to the configured Image Preset.
- Asset delivery outputs appear blurry or always render at a fixed resolution.
Cause
Dynamic Media uses fit and scaling settings to control how images render when source and output dimensions don’t match. When an Image Preset or delivery URL lacks the appropriate fit mode, Dynamic Media preserves the original aspect ratio and adds white padding. Disabled upscaling prevents image enlargement and causes white borders or missing zoom behavior. Default view-size settings can also restrict the delivered resolution unless you apply scale=1.
Resolution resolution
Follow these steps to resolve the issue
- Compare the delivered image with the original asset and identify whether the issue involves white space, missing upscaling, incorrect aspect ratio, fixed output size, or blurry rendering.
- Open the affected Image Preset in Tools
>Assets>Image Presets and review the configured image modifiers. - For white space caused by aspect-ratio differences, add or update the modifier with
fit=fit,1. Addbgc=FFFFFFwhen a white background is required. - For white borders caused by disabled upscaling, replace
fit=crop,0withfit=crop,1,and save the preset. - For aspect-ratio issues, use
fit=crop,1or request only one dimension, such as wid, to preserve image proportions. - If Dynamic Media doesn’t enlarge smaller images, add
fit=fit,1to the Image Preset or delivery URL. - If rendition previews show an unexpected aspect ratio, review the configured fit mode and update it to the intended setting.
- If Dynamic Media always delivers a fixed image size, review the Default view size setting in the Dynamic Media Publish Setup and test the delivery URL with
scale=1. - If images appear blurry through Asset Delivery APIs, specify explicit width and crop parameters when generating the delivery URL.
- Save and republish the updated Image Preset. Validate the updated rendition with portrait, landscape, and non-standard aspect ratios assets to confirm the expected output.