Skip to main content

Display Names

Display names are human-readable identifiers used for export filenames. Every image in VariantLab gets a display name.

Why Display Names?​

Internally, VariantLab uses UUIDs for all images (e.g., a1b2c3d4-e5f6-7890-...). Display names provide:

  • Readable filenames when you export
  • Consistent naming across your project
  • Traceability - know what each file contains

Naming Patterns​

Each image type follows a specific pattern:

TypePatternExample
Base imagebase_{slot}base_1, base_2
Maskmask_{trait}_v{version}mask_eyes_v1
Variationvar_{trait}_p{prompt}_v{version}var_eyes_p0_v1
Layerlayer_{trait}_orig or layer_{trait}_pNlayer_eyes_orig
Combinationfinal_{combo_code}final_eyes_v0_hat_v2

Trait Abbreviation​

Long trait names are abbreviated to keep filenames concise:

Single-word traits: First 4 characters

  • wheels → whee
  • background → back
  • eyes → eyes

Multi-word traits: Initials

  • front_bumper → fb
  • side_mirror → sm
  • left_arm → la

Version Numbers​

  • vN - Mask or variation variant number (1-5)
  • pN - Variation prompt index (0, 1, 2...)
  • orig - Original layer (from base image)

Combination Codes​

Combination names encode which layer was used for each trait:

final_eyes_v0_hat_v2_back_v1

Breaking this down:

  • eyes_v0 → Original eyes layer (v0 = original)
  • hat_v2 → Hat variation prompt #2
  • back_v1 → Background variation prompt #1

Collision Handling​

If a display name already exists in the same project/type, a numeric suffix is added:

base_1
base_1_2  (second image with same pattern)
base_1_3  (third image with same pattern)

This ensures every file has a unique name during export.

Export Filenames​

When you export, filenames are based on display names:

my-project-export/
├── final_eyes_v0_hat_v1.png
├── final_eyes_v0_hat_v2.png
├── final_eyes_v1_hat_v1.png
├── final_eyes_v1_hat_v2.png
└── ...

Tips​

  1. Keep trait names short - Shorter names = cleaner filenames
  2. Use underscores - Spaces are converted to underscores automatically
  3. Check before export - Preview filenames in the Export page
  4. Understand the code - v0 always means original, v1+ means variation