🎨 Zones & restrictions

Fine-grained configuration of each colorable zone of the 3D model.

Where zones come from

A zone is a part of the garment the customer can color independently (front, back, sleeves, collar…). Zones are extracted automatically when a GLB is dropped on the product page:

One zone per mesh primitive. Each primitive of the GLB becomes a zone.
The material name is the zone name. The name is resolved in this order: material name (in CLO3D exports, one material = one named zone) → mesh name → "Zone N". If several primitives share the same material name, a numeric suffix is added ("Front 1", "Front 2").
Zones can be renamed in the zone editor, and extra zones can be added or removed manually.

The result is stored in the product's zones_config (a zones array plus per-zone settings, indexed by zone position). See Products for GLB good practices.

Default colors

Each zone has a default color — the color the garment shows when the configurator opens. On extraction it is read from the GLB material's PBR base color; it falls back to #333333 when the material has none. You can change it with the color picker in each zone row (default_colors in zones_config).

Per-zone restrictions

Every zone has a restrictions panel (the 🔒 button on the zone row). Restrictions are stored per zone index in zones_config.zone_restrictions:

Restriction	Meaning
`lock_color`	The zone's color is fixed and cannot be changed at all.
`allowed_colors`	Restricted palette for this zone: a comma-separated list of hex codes or Pantone names. Empty = all colors allowed.
`no_text`	No text elements (including player names) on this zone.
`no_number`	No numbers (player numbers) on this zone.
`no_logo`	No logos, images or shapes on this zone.
`no_pattern`	No background patterns on this zone.
`no_drawing`	No freehand drawing (studio mode) on this zone.

What the end customer sees

Restrictions are enforced visually in the configurator, applied each time the customer selects a zone:

Locked color — the whole color panel is covered by a "Color locked — not editable for this zone" overlay.
Restricted palette — swatches whose color is not in allowed_colors are hidden; only the allowed colors remain clickable.
Blocked text / number / logo — the corresponding "add" buttons are disabled and greyed out, with a tooltip explaining the element is forbidden on this zone.
Blocked patterns — the patterns panel is covered by a "Patterns locked" overlay.
Blocked drawing — the freehand toolbar is disabled with a lock cursor.

Because restrictions are indexed by zone, switching to another zone immediately re-enables anything that zone allows.

Typical uses

Keep a sponsor area untouched: lock_color + no_text/no_logo on that zone.
Enforce club colors: set allowed_colors to the club's hex/Pantone list on visible zones.
Keep collars and cuffs plain: no_pattern + no_drawing.