Image & Video APIs

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.

✔️ Feedback sent!

Rate this page:

one star two stars three stars four stars five stars