Ask AI
Troubleshooting and tips
Last updated: May-16-2026
This section provides troubleshooting guidance and useful tips for image delivery and transformations.
These topics answer questions that are commonly asked by actual Cloudinary customers.
| Page | Description |
|---|---|
| Troubleshooting image transformation errors | Use the interactive X-Cld-Error inspector tool to quickly diagnose transformation URL errors by inspecting response headers. Learn about common transformation issues and how to resolve them. |
| How to diagnose 40x and X-Cld-Error codes 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 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 applies gzip compression only to 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. |
| 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. |
| Why is my image blurry? | Explains the two most common reasons for image blurriness and how to address each using DPR and sharpening transformations. |
| How to offset face-detection gravity when cropping | Learn how to nudge or offset the crop position relative to a detected face when using g_face gravity. |
✖️
Error
Rate this page:
