Troubleshooting failed upload requests

X-Cld-Error from failed API upload requests

• Check the x-cld-error message in the response header

• Using the response from the X-Cld-Error will help point in the correct direction to resolve the issue. For example, if the error message indicates that the cloud_name wasn't found, then we would want to double-check the configuration.

Failed Upload Widget request error message

When uploading via the Cloudinary Upload Widget, the widget returns an error message if the upload process fails. In most cases, this provides enough information to understand the root cause of the error and how to resolve it, similar to the x-cld-error message returned from API requests. If there are any errors during the upload process, the error message appears on the top-left hand side of the Upload Widget opposite an exclamation mark, indicating an unsuccessful request.

Most common causes for errors

Configuration issues

Any issues with the Cloudinary configuration setup for both the API and the Upload Widget results in Upload errors.

Account limits

Every account is subject to limitations, depending on the account plan and setup. Here is a full list of the account limitations for each plan.

Contact support

If the error message is too vague, or you are unfamiliar with the error and how to proceed, please contact our support team and provide details of the upload request and the error message you received.