Ask AI
Cloudinary Image troubleshooting and tips
Last updated: Mar-12-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 am I getting a 404 (or other 40x errors) for one transformation URL while other transformed versions of that asset work? | Explains why 40x errors are cached at the CDN and how to resolve issues when some transformed assets return errors while other versions work. |
| How to Add a Solid Color Overlay | Learn how to apply solid color overlays to images using a 1x1 pixel image, with options to resize, recolor, position automatically, and adjust opacity. |
| 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. |
| Why am I seeing a long time to first byte (TTFB) on WebPageTest.org? | Explains why WebPageTest may show a long TTFB for assets delivered via HTTP2 and how to optimize performance. |
| 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. |
| How to detect corrupted images | Learn how to identify and handle corrupted JPEG images during upload by using the IsCorrupt parameter. |
| Force specific image when sharing links on Facebook | Learn how to use Facebook's Open Graph og:image property with Cloudinary URLs to control which image appears when sharing links on Facebook. |
✖️
Error
Rate this page:
