> ## Documentation Index
> Fetch the complete documentation index at: https://cloudinary.com/documentation/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

![Upload widget error message example](https://cloudinary-res.cloudinary.com/image/upload/f_auto/q_auto/bo_1px_solid_grey/docs/ts/20884311708946 "thumb: w_700,dpr_2, width: 700, popup:true")

## 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](https://cloudinary.com/pricing/compare-plans) for each plan.

> **NOTE**: Custom limits may apply to your account. [Contact support](https://support.cloudinary.com/hc/en-us/requests/new) if you need to adjust them.

## 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](https://support.cloudinary.com/hc/en-us/requests/new) and provide details of the upload request and the error message you received.