Skip to main content

Cloudinary asset naming conventions

Overview​

This document should be our single source of truth for asset naming conventions in Cloudinary. There are 8 folders in Cloudinary - mannequin, triptych, location, event, studio-campaign, graphics, paginated-carousel and bundles, and each has it's own naming convention. Asset names are checked through the use of upload presets, which will compare the asset name against the naming convention and will fail to upload the asset if it does not match.

Mannequin​

  • <BASE-PRODUCT-SKU>_<VARIANT-COLOR>_<PRODUCT-NAME>_<SEASON>_<IMAGE-TYPE>_<ORDER>.filetype
  • The asset name must start with the base product sku and then the corresponding style variant
  • BASE-PRODUCT-SKU must have 7 characters depending on the type of product e.g. apparel PTTO2SS
  • VARIANT-COLOR must have 3 or 6 characters depending on the type of product e.g. apparel BLK, e-voucher XXXXXX
  • PRODUCT-NAME - each word of the product name should be separated by - not _
  • Product name must contain only alphabetic characters (no spaces) and hyphens, try not to use long names as there are character limits
  • SEASON is not case sensitive, but it must be 4 or 5 characters where the 5th character can only be - e.g. h1-22, H122, h122
  • IMAGE-TYPE is one of MANNEQUIN, MACRO or MODEL
  • ORDER - filename must finish with a number for ordering. This can be 1 or 2 characters e.g. 1, 01, 10, 2
  • You must an underscore character to separate the different parts of the file name
  • Keep filename as short as possible

Triptych​

  • <BASE-PRODUCT-SKU>_<PRODUCT-NAME>_<SEASON>_<IMAGE-OR-VIDEO-TYPE>_XX.filetype
  • BASE-PRODUCT-SKU must have 7 or 5 characters depending on the type of product e.g. apparel PTTO2SS, e-voucher EVR01
  • PRODUCT-NAME - each word of the product name should be separated by - not _
  • SEASON is not case sensitive, but it must be 4 or 5 characters where the 5th character can only be - e.g. h1-22, H122, h122
  • IMAGE-OR-VIDEO-TYPE is one of MANNEQUIN, MACRO or MODEL
  • This naming convention will be used for images and videos in the triptych
  • XX - this can be anything - this is optional
  • You must an underscore character to separate the different parts of the file name
  • Keep filename as short as possible

Location​

  • <SEASON-OR-YEAR>_location_<COLLECTION>_<LOCATION>_<FILE-NUMBER>.filetype or <SEASON-OR-YEAR>_<COLLECTION>_<LOCATION>_XX.filetype
  • SEASON-OR-YEAR - either the season or the year that the asset was created. Must be either 4 digit year or 4 or 5 character season either upper or lower case e.g. 2022, h122, H122, h1-22
  • location - the word "location" - this is optional
  • COLLECTION - the collection that is featured in the asset
  • LOCATION - the location in which the asset was created
  • XX - this can be anything - this is optional
  • You must an underscore character to separate the different parts of the file name
  • Keep filename as short as possible

Event​

  • <SEASON-OR-YEAR>_event_<EVENT-NAME>_<COUNTRY>_XX.filetype OR <YEAR>_<EVENT-NAME>_<COUNTRY>_XX.filetype
  • SEASON-OR-YEAR - either the season or the year that the asset was created. Must be either 4 digit year or 4 or 5 character season either upper or lower case e.g. 2022, h122, H122, h1-22
  • event - the word "event" - this is optional
  • EVENT-NAME - the name of the event
  • XX - this can be anything - this is optional
  • You must an underscore character to separate the different parts of the file name
  • Keep filename as short as possible

Studio-campaign​

  • This folder does not have a naming convention

Graphics​

  • This folder does not have a naming convention
  • This folder does not have a naming convention

Bundles​

  • BUN-<YEAR-SEASON-NUMBER-COMBINATION>.filetype
  • BUN is the letters BUN
  • SEASON-NUMBER-COMBINATION is a 6 character number and letter SKU that details the season and number for the bundle e.g. H12204
  • SEASON-NUMBER-COMBINATION must be uppercase
  • Only hyphen is allowed in between BUN and the year season combination, not underscore
  • No other detail is allowed in the filename