File naming recommendations
Last updated
Was this helpful?
Last updated
Was this helpful?
The platform is using AWS S3 storage under the hood, and while the platform offers full UTF-8 support for metadata, it is recommended for you to use only certain characters when uploading your files to the platform, not only to ensure compatibility with the platform itself, but also and more importantly, with 3rd party components and tools you may want to use in the future.
This way, in order for you to avoid future limitations and shortcomings, it is recommended to consider the following guidelines to name your files:
These are characters that are generally safe to use in key names across the platform:
Alphanumeric characters
0-9
a-z
A-Z
Special characters
Exclamation point (!)
Hyphen (-)
Underscore (_)
Period (.)
Asterisk (*)
Single quote (')
Open parenthesis (()
Close parenthesis ())
Although they are safe characters, it is not recommended to use periods (.) at the end or as a prefix for files and folders, as these characters could be removed when handled.
These characters will be recognized by the platform and your AWS S3 storage but might require additional code handling when using third parties (i.e. browser applications):
Ampersand ("&")
Dollar ("$")
character ranges 00–1F hex (0–31 decimal) and 7F (127 decimal)
'At' symbol ("@")
Equals ("=")
Semicolon (";")
Forward slash ("/")
Colon (":")
Plus ("+")
Space – Significant sequences of spaces might be lost in some uses (especially multiple spaces)
Comma (",")
Question mark ("?")
The following characters are not recommended at all as part of any of the namings across the platform:
Backslash ("\")
Left curly brace ("{")
Caret ("^")
Right curly brace ("}")
Percent character ("%")
Grave accent / back tick ("`")
Right square bracket ("]")
Quotation marks
'Greater Than' symbol (">")
Left square bracket ("[")
Tilde ("~")
'Less Than' symbol ("<")
'Pound' character ("#")
Vertical bar / pipe ("|")
Non-printable characters (128–255 decimal characters)