1. Home
  2. Docs
  3. XcooBee Concepts
  4. Crossing Storage Systems
  5. File Names

File Names

Although with XcooBee you can use any UTF-8 character in the file name, the following file naming best practices help ensure maximum compatibility with other applications and other users.  Each user’s computer or receiving application may parse special characters differently. The following guidelines help you maximize compliance with DNS, web safe characters, XML parsers, and other APIs.

Safe Characters

The following character sets are generally safe for use in file names:

  • Alphanumeric characters [0-9a-zA-Z]
  • Special characters !, -, _, and .

The following are examples of valid file names:

  • 4dt-company
  • my.super_great_album-2015-summer.jpg
  • nothing!to see here.JPG
  • 99-luftballons.png

Overall File Naming Rules

XcooBee File Naming Rules allow files to use:

  • UTF-8 alphanumeric characters
  • special characters:  !, -, _, and .

Reserved Characters (cannot be used)

  • Control characters (0x00–0x1f and 0x7f–0x9f)
  • Range (0xA0 – 0xFF)
  • Reserved characters (#, %, =, @, {, }, `, ^, [, ], ~, /, ?, < , >, \, ;, :, *, |, ‘, &, “, and comma)
  • Unix reserved filenames (. and ..)
  • repeat of $ more than once, e.g. $$, $$$, $$$$ etc.
  • Trailing periods and spaces
  • Windows reserved filenames (CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, and LPT9)


When you submit file names with invalid characters or parts via our API your transaction will produce an error. You will have to resubmit with acceptable file names.

Automatic replacements

When you submit a filename that has invalid characters using our UI we may replace it with underscore (_). You can, then, edit the filename if you wish before proceeding.

Was this article helpful to you? Yes No

How can we help?