File Naming Conventions

File Naming Conventions
To ensure maximum access to your records, establish a naming convention for your files and use it consistently. Make sure that your file names are descriptive and provide contextual information that allows the file to be identified outside of the folder where it is located, and document your file naming procedures to ensure others in your lab or department are employing the same conventions. If the file is moved or shared, users will be able to identify the file from its file name.

Consider including a combination of the following information:

  • Project or experiment name or acronym

  • Lab name/location

  • Researcher name/initials

  • Date or date range of experiment

  • Reference to lab notebook record

  • Type of data

  • Experiment conditions

  • Version number of file


Other tips for file naming:

  • The computer arranges files by name, character by character. Therefore, put the most important information first. If you anticipate wanting to find a file by date, then put the date first.

  • A good format for date designations is YYYYMMDD. This format makes sure all of your files stay in chronological order. To add a timestamp to your filename, use the format YYYYMMDDThhmm. Use 24-hour military time to avoid any confusion over a.m./p.m.

  • When using a sequential numbering system, use leading zeros for clarity and to make sure files sort in sequential order. For example, use "001, 002, ...010, 011 ... 100, 101 ..." instead of "1, 2, ...10, 11 ... 100, 101 ..."

  • Use versioning to indicate the most current version of a file, e.g. filename_v2.xxx

  • Try not to make file names too long; operating systems have different limits to the number of characters. As a general rule, try to aim for a 40-50 character limit.

  • If you find that you are encoding a large amount of metadata in the file names, you should consider storing this metadata in a master spreadsheet that can be stored with your data for future reference.

  • Avoid special characters, such as:  

    ~ ! @ # $ % ^ & * ( ) ` ; : < > ? . , [ ] { } ' " |
  • Do not use spaces as some software will not recognize file names with spaces. File names with spaces must be enclosed in quotes when using the command line. Other options include:

    • Underscores, e.g. file_name.xxx

    • Dashes, e.g. file-name.xxx

    • No separation, e.g. filename.xxx

    • Camel case, where the first letter of each section of text is capitalized, e.g. FileName.xxx

  • Do not use carriage returns in file names.

 

Examples

Files with no naming convention:

  • Test data 2016.xlsx

  • Meeting notes Jan 17.doc

  • Notes Eric.txt

  • Final FINAL last version.docx

Files with a naming convention:

  • 20160104_ProjectA_Ex1Test1_SmithE_v1.xlsx

  • 20160104_ProjectA_MeetingNotes_SmithE_v2.docx

  • ExperimentName_InstrumentName_CaptureTime_ImageID.tif

 

Last Updated: 2016-12-16