Asset management troubleshooting and tips
Last updated: May-20-2026
This section provides troubleshooting guidance and useful tips related to asset management.
These topics answer questions that are commonly asked by actual Cloudinary customers.
| Page | Description |
|---|---|
| Admin API authentication issues | Learn how to troubleshoot Admin API authentication problems when receiving HTML responses instead of JSON data. |
| Why has an asset's public ID changed? | Explains the common reasons why an asset's public ID might change and best practices for managing these changes. |
| Checking the resource type and delivery type of an asset | Learn how to verify the resource type and delivery type of uploaded assets by examining the delivery URL or checking the Console. |
| Getting the size or dimensions of an asset by its public ID | Learn multiple methods to retrieve image and video dimensions, including via API responses, Admin API queries, and the Console UI. |
| Downloading your account's assets | Learn about the different methods to download assets from your Cloudinary account, including using the API, CLI, backups, ZIP archives, or the Media Library UI. |
| Deleting or modifying the original image uploaded | Learn how to delete original assets and their derived versions, or modify original images using incoming transformations. |
| Does Cloudinary store any cookies? | Explains Cloudinary's cookie usage policy and how Cloudinary handles cookies in asset delivery requests. |
| When might underscores in public IDs or folder names cause errors? | Learn why underscores in the first few letters of a public ID containing slashes or in a folder name (in fixed-folder mode) can cause ambiguity and broken URLs, and best practices to prevent these issues. |
| How to update an already fetched asset? | Learn how to update an asset that was previously fetched and then updated via the original remote URL using the UI or API methods. |
| Upload, manage and deliver PDFs | Learn how to upload, manage, transform, and deliver PDF files in Cloudinary, including conversions, text extraction, and security settings. |
| Deleting the "sample" image | Learn why Cloudinary automatically recreates the sample images (cld-sample to cld-sample-5) and how to replace them with your own image. |
| Avoiding duplicate uploads | Learn how to use MD5 signatures, pHash similarity checks, ETag as public_id, and the Duplicate Image Detection add-on to avoid or detect duplicate uploads. |
| Permitted naming conventions | Reference for the allowed length, characters, and other naming rules for Cloudinary cloud names and asset public IDs. |
✖️