Docs/Products/Variation Options

Variation Options

Product version: 1.0.0+1 Last updated: 2026-08-03 Audience: Tenant users with product:variant:read (mutations use product:variant:*)

A. What Are Variation Options?

A Variation Option is a specific value within a variation dimension. While a variation defines what you can vary (e.g., "Color"), a variation option defines the specific value (e.g., "Red").

Examples

Variation Options
Size XS, S, M, L, XL, XXL
Color Red, Blue, Green, Black, White
Material Cotton, Polyester, Linen, Wool
Storage 128 GB, 256 GB, 512 GB, 1 TB

B. Viewing Options for a Variation

  1. Go to Product Catalog > Variations.
  2. Tap a variation row — this opens the Variation Options list page for that variation (there is no separate variation “detail” screen in the app).
  3. The list shows options (searchable). Typical columns:
Column Description
Value Option value text (e.g., "Red", "Large")
Swatch Color preview when the variation display type is swatch_color
Updated Last modification time (when shown)

Tip: Sort / display order is controlled by the option’s display order field when set on create/edit.

C. Creating a New Option

Required permission: product:variant:create

  1. Open the variation’s options list from Product Catalog > Variations.
  2. Tap Add Option.
  3. Fill the dialog:
Field Required Description
Value Yes Option value (e.g., "Red", "Extra Large")
Display Order No Numeric sort position (lower first)
Color hex No Shown only when the parent variation’s display type is swatch color. Format #RRGGBB
  1. Save.

Option values should be unique within a variation.

Color swatches

For variations with display type swatch color, set a hex color on the option. Lists and selectors can show an AppColorSwatch next to the value.

Note: There is no bulk-paste or drag-and-drop reorder UI in the current app. Add options one at a time; change display order via edit.

D. Editing an Option

Required permission: product:variant:update

  1. Open the variation’s options list.
  2. Tap Edit on the option.
  3. Change Value, Display Order, and/or Color hex (when applicable).
  4. Save.

Warning: Renaming an option updates the label everywhere that option is referenced. Configurations remain linked to the same option id.

E. How Options Combine to Create SKU Configurations

  1. Variations (optionally scoped to a category) expose dimensions such as Color and Size.
  2. Each variation has options (Red, Blue / S, M, L).
  3. When you create or edit a product item, you pick options (one per relevant variation).
  4. The app stores selections as Product Item Configuration rows.
  5. You do not need every combinatorial SKU — only the variants you sell.

See Items for the Variants panel on item detail.

F. Reordering Options

Required permission: product:variant:update

  1. Open the options list.
  2. Edit an option and change its Display Order number.
  3. Save. Lower numbers appear first; value is used as a tiebreaker.

G. Deleting an Option

Required permission: product:variant:delete

  1. Open the options list.
  2. Delete the option (confirm when prompted).

If the option is still referenced by product item configurations, the API returns an error (conflict) and the option is not removed until those configurations are cleared.

Previous: Variations

Related: Overview · Products · Items · Brands · Categories

See also: Tenant Owner Manual · Employee Manual