Naming Conventions

Prev Next

Bucket Names

A bucket name is visible in the URL that points to the objects you will put in the bucket. Use a unique DNS-compliant name for a bucket. You should develop a naming strategy following these guidelines:

  • The name must be unique across all existing bucket names in Wasabi. A bucket name must:

    • Be a valid DNS-compliant name

    • Begin with a lowercase letter or number, and

    • Consist of 3 to 63 lowercase letters, numbers, periods, and/or dashes.

    The name cannot contain underscores, end with a dash, have consecutive periods, or use dashes adjacent to periods. And, the name cannot be formatted as an IP address (123.45.678.90).

  • Choose a bucket name that reflects the objects you will store in the bucket.

File Names

Avoid the use of the following special characters in a file name:

     % (percent)
     < (less than symbol)
     > (greater than symbol)
     \ (backslash) # (pound sign)
     ? (question mark)

Certain file names may have non-ASCII characters that are 4 byte UTF8 characters (such as emojis). Wasabi does not support these characters and will return a 400 error message to an application that tries to write a file with 4 byte UTF characters in the file name. We recommend renaming the affected files, if possible.