Cloudinary Image troubleshooting and tips
Last updated: Jan-19-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 |
|---|---|
| Transforming PSD layers with self-referencing variable | Learn how to transform specific layers of PSD assets using self-referencing variables to dynamically reference and manipulate layers with custom transformations. |
| How to perform an unsigned image upload from Google Apps Script to Cloudinary | Learn how to upload images to Cloudinary using Google Apps Script with UrlFetchApp service. |
| How to Add a Solid Color Overlay? | Learn how to apply dynamic solid color overlays to images using a 1x1 pixel image technique, including resizing, coloring, positioning, and adjusting opacity. |
| How to always upload a square image | When uploading images to Cloudinary you can specify the dimension and crop on upload to always have a square image. |
| 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. |
| 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. |
| Why was my uploaded image truncated? | Learn how to detect and handle truncated images when uploading from remote servers, including using the IsCorrupt attribute for JPEG files. |
| 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. |
| I'm getting a 404 (or other 40x errors) for my transformed image while other versions of that image work | Explains why 40x errors are cached at the CDN and how to resolve issues when transformed images return errors while other versions work. |
| 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. |
| Troubleshooting failed upload requests | Learn how to troubleshoot failed upload requests by checking X-Cld-Error messages from API uploads and error messages from the Upload Widget. |
✖️