If you or your customers receive an error when accessing a file, it's possibly due to a special character that created an issue during upload.


When naming your files, it's important to avoid certain special characters.


The following article includes information about characters to avoid when uploading your files:


https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#object-keys


The specific information regarding characters is below. Keep in mind that we recommend avoiding all of the following characters:


Characters That Might Require Special Handling

The following characters in a key name might require additional code handling and likely need to be URL encoded or referenced as HEX. Some of these are non-printable characters that your browser might not handle, which also requires special handling:


  • Ampersand ("&")
  • Dollar ("$")
  • ASCII character ranges 00–1F hex (0–31 decimal) and 7F (127 decimal)
  • 'At' symbol ("@")
  • Equals ("=")
  • Semicolon (";")
  • Colon (":")
  • Plus ("+")
  • Space – Significant sequences of spaces might be lost in some uses (especially multiple spaces)
  • Comma (",")
  • Question mark ("?")


Characters to Avoid

Avoid the following characters in a key name because of significant special handling for consistency across all applications.


  • Backslash ("\")
  • Left curly brace ("{")
  • Non-printable ASCII characters (128–255 decimal characters)
  • 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 ("|")