Cloudinary provides several methods to help you understand why a request to deliver an image or video asset failed, including debugging specific URLs, all URLs included on a webpage, and details of errors that occur for any asset in your account.
X-Cld-Error header
There are multiple cases which can cause an asset not to appear, and in addition to using standard HTTP status codes to indicate common error reasons, Cloudinary sends a custom HTTP header to provide Cloudinary-specific information about the reason for the failure.
This header is called x-cld-error, and you can see the value by checking the HTTP response headers sent when your browser tried to load the asset's delivery URL.
Accessing the x-cld-error header with browser debug tools
The precise instructions may differ slightly between browsers, but if you open your browser's Developer Tools and view the Network tab, you can see the request and response headers for HTTP requests made by your browser when loading the current webpage.
You may need to refresh the page to see the requests in the Network tab, as it may not record the requests made before you opened the Developer Tools section.
If you've opened an image URL directly in a new tab or a new window, you may also need to click the "preserve log" option before refreshing, so that when the browser shows an error message in that tab, the developer tools aren't showing you just error page's details but also the earlier request for the image or video file.
In the network tab, if you click a specific request, you can see the request and response headers including the X-Cld-Error header with the specific error message.
For more information, refer to our support article on common error codes returned in the x-cld-error header during asset delivery: https://support.cloudinary.com/hc/en-us/articles/21176631529106-Common-Error-Codes-Returned-in-the-x-cld-error-Header-when-Delivering-Assets
Cloudinary Media Inspector
Cloudinary has released a debugging extension for use with the Google Chrome web browser, and you can find it in the Chrome Web Store: https://chrome.google.com/webstore/detail/cloudinary-media-inspecto/ehnkhkglbafecknplfmjklnnjimokpkg
The Media Inspector tool shows you a summary of all media assets loaded on the current page, and where the asset was loaded from Cloudinary, it also shows details of the transformations options used, and if the request was an error, details about the reason for that error, taken from the x-cld-error HTTP header mentioned above.
For example debugging a successful request for an original media asset with no transformations applied produces the following result:
And debugging a request which failed because the Transformation parameters in the URL were invalid shows the reason for the error with both the HTTP status code, and the x-cld-error HTTP header:
Error reports
On paid Cloudinary plans, your account's reports section includes details of errors that occurred when Cloudinary received requests to deliver assets from your account.
The Error reports section shows the most common HTTP error codes, and provides a summary of the specific errors, including the exact URLs that were requested to cause the error, and the HTTP Referer value, if it was provided to us.
Comments
4 comments
Hi Cloudinary team! one question!
Im trying to share a Cloudinary URL of one of my images on Twitter but when I post it there is no visualization of the image in the body of the tweet, only the URL. Is there a way to achieve the preview or visualization of the image setting the meta data?
thanks for the reply!
Hi there,
This is actually not controlled by Cloudinary You can do this with the meta tags of the HTML.
I hope this helps. If you have any questions at all, do not hesitate to ask.
Kind Regards,
Tia
Hi Tia!
Thanks for the reply! Yes, you are right! Its posible to get the visualization of images setting the right properties with the <meta> tags in a HTML file but in this case the image is hosted at Cloudinary.
In summary, I have a twitter share button in one of my websites, when you click it internally one script is taking a screenshot of the website, sending the screenshot to cloudinary via Cloudinary API and at the same time opening a tab on twitter with a text and the secure_url of the image hosting in Cloudinaty at the tweet body.
What im trying to achieve?
the same behavior but I want the secure_url at the tweet body have the correct meta data to get a pre-visualization or visualization of the image when I click "Post" on Twitter.
Hoping to be clear with my explination.
Thanks anyways for your reply!
Hi there,
Thanks for the additional information. So as I'm understanding it - you want to paste a Cloudinary asset URL into a tweet and have Twitter pick up a description.
That will not be possible (from Twitter's side, that’s not how previews work).
You could share the URL of a webpage, maybe even a simple one, where the Cloudinary image URL is listed in the metadata of that page, as well as the title and description you want Twitter to use.
Let me know if this helps or if I'm still not properly understanding your question.
Kind Regards,
Tia
Please sign in to leave a comment.