Product SKU generation

When a new product is created in Valigara, the system automatically generates an SKU (Stock Keeping Unit) — a unique identifier for the product. The SKU is based on product information to make it more readable and informative.

• SKU Mask
• Conditions
• Increment Value
• Product Variations SKU
• Maximum Symbols

SKU Mask

The SKU mask defines the format of the generated SKU. To create or edit the SKU mask:

1. Go to Global Settings → General and scroll to the SKU generation block
2. Click Expand on the Product SKU Fields row
3. Build the mask using the available buttons:
   • Add field — adds a product field selector (e.g. Model Code, Metal Code, Gemstone Color)
   • Add Free field — adds a fixed value (e.g. brand name, prefix, separator like -)
   • Add Increment value — adds an auto-incrementing number (see Increment Value below)
4. Use the drag arrows to reorder the fields
5. Check Separate to add a - separator after a field

Conditions

Conditions allow setting different SKU masks for different product types. If a product matches a condition, Valigara uses the mask defined for that condition. If no condition matches, the Default mask is used.

To add a condition:

1. Click + Add to create a new SKU mask block
2. Click + Add condition in the new block
3. Define the condition rule (e.g. product type = Ring)
4. Build the mask for that condition using Add field, Add Free field, or Add Increment value

Example: Default mask BRAND-[MODEL_CODE], condition for Rings: R-[MODEL_CODE]-[SIZE], condition for Pendants: P-[MODEL_CODE]-[METAL_CODE] Each product type gets its own SKU format automatically

Increment Value

Increment adds an auto-incrementing number to the SKU. Each new product or variation group receives the next number in sequence.

• Set a starting number (e.g. 1000)
• Each newly generated SKU gets the next value: 1000, 1001, 1002, etc.
• Products in the same variation group share the same increment value

To add an increment, click + Add Increment value in the mask builder and set the starting number.

Product Variations SKU

A separate SKU mask can be set for field-based variation sub-products. This allows including variation-specific information in the SKU.

• -s7.5 — identifies ring size 7.5
• -red — identifies a color variant

Configure it in the Product Variations SKU Fields block, using the same mask builder.

Maximum Symbols

Defines the maximum length of the generated SKU. If the result exceeds the limit, Valigara shortens it in this order:

1. Removes separators
2. Shortens field values character by character (e.g. "Earrings" → "Earring" → "Earrin" → ...)
3. If the result still collides with an existing SKU, appends the unique Valigara internal ID

Remember to update the SKUs of existing products after changing the SKU mask