Image & Video APIs

Cloudinary Image troubleshooting and tips

Last updated: Jan-21-2026

This section provides troubleshooting guidance and useful tips related to Cloudinary Image.

These topics answer questions that are commonly asked by actual Cloudinary customers.

Page Description
Why are my Cloudinary images delivered without gzip compression (Content-Encoding)? Explains why Cloudinary gzips only compressible formats and how to inspect the Content-Encoding response header.
How can I update a named transformation? Learn different methods to update a named transformation in Cloudinary, including using the management console, Admin API, and CLI SDK to regenerate derived assets.
What's the difference between Cloudinary's automated cropping and Imagga's smart cropping Understand the differences between Cloudinary's built-in content-aware cropping and the Imagga smart cropping add-on, including algorithm differences, configuration options, and quota considerations.
Suggested transformation options for placeholder images/ LQIP Suggested transformation options for low-quality image placeholders (LQIP) to use for responsive design or lazy-loading implementations.
What are the common error codes returned in the x-cld-error header when delivering assets? A reference guide to troubleshoot and resolve common x-cld-error codes returned by Cloudinary when delivering assets, with causes and solutions for each error.

✔️ Feedback sent!

Rate this page:

one star two stars three stars four stars five stars