Ask AI
Menu
- Get Started
- Image & Video APIs overview
- Developer kickstart
- SDK quick starts
- Try it!
- MCP servers and LLM tools (Beta)
- VS Code Extension (Beta)
- Video tutorial library
- Programmatic asset management
- Programmatic upload
- Upload programmatically
- Upload with Fetch API
- Create upload presets (Node.js)
- Create upload presets (Console UI)
- Auto upload
- Moderate images with AI
- Use AI to generate image captions
- Upload images in Flutter
- Upload images in Node.js
- Auto-tag images in Node.js
- Upload multiple files in Node.js
- Upload videos in Node.js
- Upload images in Python
- Auto-tag images in Python
- Upload videos in Python
- Upload images in PHP
- Upload images in Go
- Upload assets in a React app
- Upload assets in a Vue.js app
- Drag-and-drop uploads in React
- Upload assets in a Next.js app
- Upload assets with Server Actions
- Upload assets in Svelte
- Upload assets in a SvelteKit app
- Upload assets in a Remix app
- Upload images in Astro
- Upload images in Hono
- Use webhooks to remove backgrounds
- Upload images in Laravel
- Interaction with Cloudinary APIs
- Cloudinary SDKs
- Find your credentials
- Configure the JavaScript SDK
- Configure the React SDK
- Configure the Angular SDK
- Configure the Flutter SDK
- Configure Svelte Cloudinary
- Configure the Javascript SDK in Svelte
- Getting started with Cloudinary in Node.js
- Configure the Node.js SDK
- Configure the Python SDK
- Configure the PHP SDK
- Install and configure Laravel SDK
- Configure the Go SDK
- Configure the Vue.js SDK
- Configure the Next.js SDK
- List images in Next.js
- Lazy load images with Next.js
- Image fallbacks in JavaScript
- Captioning on upload with Node.js
- Delete assets with Node.js
- Manage images in a Django app
- Cloudinary CLI
- Widgets and tools
- Programmatic upload
- Optimization and delivery
- Transformations
- Get started with transformations
- Advanced transformation features
- Text overlay transformations
- Add watermarks in JavaScript
- Complex transformations
- Named transformations
- Named transformations using TX Builder
- Advanced image components
- Trim videos in Node.js
- Splice videos in Node.js
- Zoompan effect
- Video transformations
- Crop and resize images in React
- Crop and resize videos in React
- Crop and resize images in Python
- Remove backgrounds and add drop shadows
- AI generative fill in Next.js
- Color accessibility in JavaScript
- Transformations for social media
- Dev Hints on YouTube
- Dev Hints en Español
- Cloudinary Café Training Sessions
- Programmatic asset management
- Additional onboarding resources
- Guides
- Cloudinary Image
- Product overview
- Image transformations
- Image transformations overview
- Resizing and cropping
- Placing layers on images
- Effects and enhancements
- Background removal
- Generative AI transformations
- Face-detection based transformations
- Custom focus areas
- Transformation refiners
- Animated images
- Transformations on 3D models
- Conditional transformations
- User-defined variables and arithmetic transformations
- Custom functions
- Image optimization and delivery
- Programmatic image creation
- Product Gallery widget
- Media Editor widget
- Image add-ons
- Troubleshooting and tips
- 404 errors for transformed assets
- Add a solid color overlay
- Images delivered without gzip compression
- Long time to first byte (TTFB) on WebPageTest.org
- Update a named transformation
- Cloudinary vs Imagga cropping
- Placeholder images (LQIP)
- Common error codes in x-cld-error header
- How to detect corrupted images
- Force specific image when sharing links on Facebook
- Cloudinary Video
- Product overview
- Cloudinary Video Player
- Video Player features
- Installation and setup
- How to embed the Video Player
- Video Player Studio
- Video Player customization
- Playlists and recommendations
- HLS and MPEG-DASH
- Video Player accessibility
- Video Player advanced features
- Video Player API reference
- Player profiles API reference
- Video config API reference
- Adaptive bitrate streaming
- Video transformations
- Video and audio optimization
- Video transcription
- Video analytics
- Live streaming
- Video add-ons
- Video best practices
- Social media videos
- Upload
- Asset management
- Account management
- Retail and e-commerce
- User-generated content
- Accessible media
- AI in action
- Native mobile
- Add-ons
- Advanced Facial Attributes Detection
- Amazon Rekognition AI Moderation
- Amazon Rekognition Video Moderation
- Amazon Rekognition Auto Tagging
- Amazon Rekognition Celebrity Detection
- Aspose Document Conversion
- Cloudinary AI Background Removal
- Cloudinary AI Content Analysis
- Cloudinary AI Vision
- Cloudinary Duplicate Image Detection
- Google AI Video Moderation
- Google AI Video Transcription
- Google Auto Tagging
- Google Automatic Video Tagging
- Google Translation
- Imagga Auto Tagging
- Imagga Crop and Scale
- Perception Point Malware Detection
- Microsoft Azure Video Indexer
- OCR Text Detection and Extraction
- Pixelz - Remove the Background
- URL2PNG Website Screenshots
- VIESUS™ Automatic Image Enhancement
- WebPurify Image Moderation
- Cloudinary Image
- References
- SDKs
- Release Notes
Upload Troubleshooting and Tips
Last updated: Mar-12-2026
This section provides troubleshooting guidance and useful tips related to uploading assets.
These topics answer questions that are commonly asked by actual Cloudinary customers.
| Page | Description |
|---|---|
| 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. |
| Why does Cloudinary reject the file format of some files I'm uploading? | Learn which file extensions are blocked by Cloudinary for security reasons and how to request exceptions for paid accounts. |
| 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. |
| How to always upload a square image | When uploading images to Cloudinary you can use an upload preset with an incoming transformation to define the dimensions and crop the image to a square on upload before storing it in your account. This enables you to normalize all images that are uploaded using that upload preset. |
| Why do I get a 'XXX parameter is not allowed' error on unsigned uploads? | Learn why unsigned uploads restrict certain parameters and how to apply transformations through upload presets. |
| 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. |
| Why am I receiving an "Upload failed: cloud_name is disabled" error when using my new Cloudinary account? | When you register for a Cloudinary account, a verification email is sent to complete the signup process. If email verification is not completed, your account cannot be used and API calls will return errors. |
✔️ Feedback sent!
✖️
Error
Unfortunately there's been an error sending your feedback.
Rate this page:
