Image naming convention overview

Configure a naming convention, so NuORDER can automatically match your media files to your products during a bulk upload or file transfer.

Add or edit a naming convention

From the left navigation menu, go to Settings > Brand Admin > Imagery & Media > Image Settings.

Navigate to Image Settings in Brand Admin.

By default, one Ruleset automatically exists in your account.

The default and any additional Rulesets display with the Ruleset Name, Ruleset Type (Standardized or Custom), Last Modified (date/time), and Description (if entered).

To edit a Ruleset, hover over it to use the ellipsis menu icon and select Edit. You can also use the ellipsis icon to Rename or Delete the Ruleset.

Edit or add a new Ruleset.

To add a new Ruleset, select New Ruleset in the upper-right corner. Enter a name, choose between the provided naming conventions (Standardized or Custom), and select Create. After you configure the ruleset, select Save.

Configuring rulesets

Depending on the rules you apply to your naming convention, NuORDER interprets and uses your file names in different ways.

Standardized and custom naming conventions

When creating (or editing) a Ruleset, specify the naming convention type: Standardized or Custom.

Type Description When to use
Standardized Create one set of rules that applies to all uploaded media files. If this is your first time creating a naming convention, use Standardized.
Custom Create a unique set of rules for each media file you upload in a series.

For example, the first image in a series might include the style number and color (example: DEMO1234444_cream_1) and the second image in a series might include the season and color (example: s20_cream_2).
If one of the following is true, use Custom:

A) Your brand uses multiple unique image naming patterns.

B) You've already set up image naming conventions in NuORDER. Check the configuration of Rulesets already in place before adding a new one.

Note: Avoid using slashes (/) and colons (:) when naming your images, as it may results in an unmatched file within NuORDER. 

Field separator

For both Standardized and Custom naming conventions, you must choose a field separator. A field separator is the character used in the name of each file to separate product attributes. Choose between: Underscore (_), Hyphen (-), or Period (.).

Examples: If you select Underscore, then a future file name may look like: STYLE_COLOR_1. If you select Hyphen, then a future file name may look like: STYLE-COLOR-1.

Select a field separator.

Naming Convention

Define the convention of your image/media file names, so that NuORDER knows how to map uploaded files to your products.

Note: Video and 3D files are unique in that NuORDER will automatically detect these file types, based on the supported file format: video (.mov, .mp4) and 3D (.GLB, .GlTF).

For Standardized naming conventions, choose the product attributes you want included in each file name (examples: style number, color, fabric material, etc). To change the selected Product field (or Custom text), use the dropdown menus to select other fields.

Select the X to remove a field and select Add Another (at the bottom of the list) to add more fields.

Set Standardized naming conventions.

For Custom naming conventions, choose the product attributes you want to include for each sequential image name. Each file uploaded can require a unique set of attributes in the name, depending on the rules you apply.

Select the X to remove a field and select Add Image/Media (at the bottom of the list) to add more fields.

Set Custom naming conventions.

Sequential order

Standardized naming conventions require that you add a number to the end of each file name so that NuORDER can accurately determine the sequence in which images should display in NuORDER.

Example: File_01.png is the first product image, File_02.png is the second, etc.

With Custom naming conventions, we recommend adding a Custom text rule at the end of each media file, so you can create your own sequential order.

Example: If you add Custom text 1 at the end of Image/Media 1 (Hero), and Custom text 2 at the end of Image/Media 2, then you must label future files as FileName_1.png and FileName_2.png for them to automatically display in the correct order.

Image/Media selections.


As you configure your naming convention, Previews display on the right, so you have examples for naming files going forward.

Example preview.

Reminder: If you're editing or creating a Ruleset, select Save in the upper-right corner of the screen when you're done making configurations.


Q: How do I name a video file in a bulk upload?

A: Name video files following the same naming convention as images. NuORDER automatically detects the file type by the extension (.mov, .mp4) and places the video in the proper place, based on your naming convention.

Q: How do I name a 360 image file in a bulk upload?

A: If you want to include 360 images in a bulk upload, each frame must also be named to include the suffix [separator]360[separator]01 where 01 denotes the frame sequence from 1 to 72 (the maximum number of frames allowed).

For example, if your naming convention contains a style number (ABC123) then a color (red), the 360 video is intended to appear in the fourth position of your media gallery, and your separator character is an Underscore, then your file name for the first image frame should be: ABC123_red_04_360_01. Subsequent files would be ABC123_red_04_360_02, ABC123_red_04_360_03, etc.

Q: How do I name a 3D file in a bulk upload?

A: Name 3D image files following the same naming convention as images. NuORDER automatically detects the file type by extension (.GLB, .GlTF) and places the video in the proper place based on your naming convention.

Q: What if a media file is missing from my upload? How will NuORDER display it in my product carousel?

A: When processing a bulk upload, NuORDER automatically matches media files to products based on the file name (as determined by your naming convention). Based on the suffix included in your file name (e.g. file_01.png, file_02.png, etc.), NuORDER also determines which media files should display first on the product details page.

If a specific file processes earlier than the other files in that carousel, NuORDER moves the images in the product carousel to ensure that the final order matches the numbers listed in the suffix of each file.

For example, if file_01.png and file_03.png process before file_02.png, during a bulk upload, NuORDER temporarily places file_03.png in the second image slot to avoid including any blank images. When file_02.png processes, NuORDER automatically moves it to the second image slot for that product and moves file_03.png to the third image slot.

Q: Does NuORDER allow for the creation of multiple naming conventions?

A: Yes. You can build multiple naming convention Rulesets. By adding multiple naming conventions, it’s possible to create different rulesets that accommodate different naming conventions for your files.

We highly recommend creating multiple naming conventions if you oversee products for multiple sub-brands within your portal.

Was this article helpful?
2 out of 3 found this helpful
Have more questions? Submit a request