Skip to content
Stone & Water
Doc · 04 Variant generator

Variant generator · 100 variants in 10 seconds

Create variants visually - pick properties, click options, define patterns, generate. With unified search, pattern accordions and the new variant matrix for bulk maintenance.

Property and option selection

  • Left: all properties of your shop (e.g. colour, size, material)
  • Right: the options of the currently selected property as chips

Click adds options to the variant list. Even with 40+ options per property the selector stays clear - with search and "Select all" button per property.

Unified search

One single search at the top filters properties and options simultaneously. Type "red" and all property groups with the option "red" stay visible while matches on the right are highlighted.

Patterns for SKU and variant name

Available variables

  • {number} - SKU of the parent
  • {parentName} - name of the parent
  • {option1}, {option2}, … - value of selected options (in click order)
  • {group1}, {group2}, … - property group name
  • {counter}, {counter:03} - sequential number

Pattern accordions

Two dedicated accordions - one for the SKU, one for the variant name.

  • Collapsed: shows the current pattern as a code chip on the right
  • Expanded: input field plus clickable variable chips
  • Clicking a chip inserts the variable directly into the active pattern
  • Focus jumps to the correct field automatically

Examples

  • Number: {number}-{option1}-{option2}SW-1001-red-S
  • Name: {parentName} ({option1}, {option2})T-Shirt Basic (red, S)

Live preview

During configuration a table shows the first 8 combinations with concrete SKU and name. For more than 8 variants, a "+ X more" hint appears.

Default patterns in the config matrix

SKU and name patterns can be set globally as defaults in the config matrix. Per-product override is possible - divergent patterns are saved in the product detail under "Variant generator".

Storefront presentation & multi-language names

After generation, the plugin automatically sets the storefront presentation like the Shopware default ("display single product → variant"). An existing pre-selection takes precedence; otherwise the variant with the lowest article number becomes the pre-selection (incl. listing configuration, top position, audit-log entry).

Parent as pre-selection: the variant list toolbar has a star-icon button "Parent as pre-selection". It sets the parent product itself as the storefront listing (variantListingConfig.displayParent = true) instead of a single variant - e.g. when the listing should show the main product with variant selection. Clicking again removes it. Setting a variant pre-selection automatically switches back, and variant generation no longer overwrites a deliberately set parent listing.

Variant names are resolved per language: parent name, option and group names are loaded with their translations and the name pattern is applied per language (fallback to the current name if a translation is missing). This prevents e.g. German option names ending up in the English variant name.

Variant matrix · Bulk prices and stock

The variant matrix lays all variants in a stacked table:

  • One axis shows the first property (e.g. colour)
  • The other the second property (e.g. size)
  • Each cell offers price and stock for direct editing
  • Property sorting via drag-and-drop
  • Optional: apply parent values to all empty cells

Safe deletion with order check

  • Mode "Safe" (recommended): Variants with open orders are not deleted, only deactivated. Data preserved for accounting and returns.
  • Mode "Complete": Variants are deleted even if orders exist.
Recommendation: Always work in "Safe" mode. Use "Complete" only for full catalogue cleanup.