Disclaimer: these requirements may change from time to time due to different design requirements.
Cloud name:
- Length: between 2 and 128 characters
- Allowed characters: a-z, A-Z, 0-9, -
- Must begin with a letter
- Must not end with “-cld” unless using a private S3 bucket
Public ID:
- Length: between 1 and 255 characters
- Allowed characters: any language character (including non-English) and in addition dot
.and dash-, as well as any HTML escaped characters (E.g.%26as opposed to&)
While '?&#\%<>+' are utterly forbidden, other special characters will be replaced with underscores_and preceding/trailing occurrences will be trimmed off - Should not begin nor end with whitespace or forward-slash (those will be omitted as well)
- You cannot use 'v' followed by numeric characters as the name of a folder.
Comments
4 comments
Hi Paul,
The details here are about which characters are permitted to be used in a folder name but how the folders are actually named will be determined by how your application or organization structures its assets or your other business requirements. We don't have any specific recommendations from our side that would generally apply to customers' use-cases.
If you're using the Media Library and are considering how permissions to folders will be granted to your account's users with their various permission levels, we do have some guidance here about how to build the hierarchy, primarily that permissions cascade downwards, and you can't "remove" access to a subfolder from a user who has access to the parent folder: https://cloudinary.com/documentation/dam_admin_users_groups#recommended_workflow
We also have this general guide about implementing best practices with our asset management features, but again the folder names would be based on how your business organises things, rather than a general 'template': https://cloudinary.com/guides/digital-asset-management/dam-best-practices-and-critical-success-factors
Regards,
Stephen
Hi Nadav,
What would be your recommendation for folder-naming? How do most of your clients name their main library of syndicated images?
Thanks,
Paul
Hi Kenneth,
Thank you for reaching out.
It looks like you are referring to the version component which is present when you copy the delivery URL from the UI or retrieve it from the API. This is not a folder in your account and you can simply remove this string from the URL without any issues.
This article explains how this works so let me know if you have any further questions?
I'm looking forward to your response.
Kind Regards,
Thomas
I seem to have a folder with a "v" followed by numbers. Not sure how that happened, how would I go about renaming it? I can't seem to find the settings to do so
Please sign in to leave a comment.