We strongly recommend you prepare and rename (if necessary) your files, before uploading them to Brandkit or any other DAM or file management system.


When you upload a file, it's filename will be preserved irrespective of what metadata you add to the Asset such as Caption, Reference, etc.

And when a user downloads the file in the future generally the downloaded file will use the original filename.

There is an exception for certain on-the-fly conversions, where Admins force a name change (e.g. a file that is renamed as barcode.xtn) and for original files if the Asset Name is modified in the Edit Asset/Advanced panel.

How to name files?

In your computer's operating system or file management application, navigate to your files and have a look at the filenames. 

You'll clearly see the files where it's obvious as to what they are all about and others that have arcane names , which require you to open them to discover what they are.

Often they are named something like, ex-1234.tif, or 2c05918a9c0a076ac49b.jpg.

These files are hard to read and give very little clue as to what the file contains. You probably can work out they are an image of some sort, but that's about it.

Think about how this might look after one of your users downloads several files. Not good.

Instead you should be looking to make your filenames meaningful, logical and human readable.

Acme Banner Image Jun 17.jpg is a much better name than: 918a9c0a076ac49b.jpg

You could write it:

  • Acme Banner Image June 2017.jpg
  • acme banner image 06 17.jpg
  • acme-banner-image-jun17.jpg
  • etc

Which ever works best for you.

Combine Folder structure in filenames

Often your files will come from a well organised folder structure. Files however have no way of knowing what folder they were in once you move them or copy them elsewhere.

You can however embed some of that hierarchy in your filenames. 

From a folder hierarchy:

> hero
> > staff portraits
> > >  John Smith.jpg

To a filename with an embedded hierarchy:

e.g. images-hero-staffportraits-john smith.jpg

The important thing here is to be consistent and check that the hierarchy that you have is accepted and important, before making the effort to name this way.

Photographers Reference, Product names, Barcodes and Other References.

If your file has a reference of some sort, it's a good idea to include these in your filename.


We generally recommend you DO NOT include the date the file was created or updated in filenames, because dates are already a core piece of metadata in the file itself. 

The exception is a more broadly defined date - such as a season (e.g. Winter), a campaign period (e.g. June or 2017, etc)

Filename length 255 Characters

255 is the maximum length (including the four .extn characters) for Filenames to ensure backwards compatibility with operating systems. 

It's also sensible to make filenames easy to read and display in file management applications, including Brandkit.

What to avoid in a filename?

There are some characters that you should not use in your filenames.

Filenames should include only letters, numbers, hyphens or underscores.

You should NOT use the following characters anywhere in a file name: 

  • Tilde ~
  • Number sign #
  • Percentm %
  • Ampersand &
  • Asterisk *
  • Braces { }
  • Backslash /
  • Colon :
  • Function ƒ
  • Angle brackets <>
  • Question mark ?
  • Slash \
  • Pipe |
  • Quotation marks "" ''
  • Apostrophe '

Permitted but may lead to issues elsewhere so should ideally be avoided.

  • Period .

Avoid special characters (e.g. Macrons), non latin scripts (e.g. Chinese characters), etc.

See this wikipedia article https://en.wikipedia.org/wiki/Filename#Reserved_characters_and_words

Happy file naming  :)

Did this answer your question?