Skip to main content

Set up the catalog

The configurator calculates quantities and prices from your catalog. The catalog is maintained entirely through Shopify metaobjects – you'll find it in the app admin or under Settings → Custom data → Metaobjects.

Catalog overview in the app admin showing the item categories

Item categories

There are six categories. Create one entry per item you sell in the matching category:

CategoryPurpose
FlooringThe decking boards themselves (e.g. WPC/BPC)
SkirtingTrim along wall edges
Heading trimTrim along open edges
Substructure beamBeam/profile of the substructure
Start profileStarting profile of the substructure
End profileEnding profile of the substructure

Common fields

Every item shares the same base fields:

FieldMeaning
ActiveOnly active items appear in the configurator
TitleDisplay name in the configurator
Width (mm)Usable width of the item in millimeters
Price per mmPrice per millimeter of length (basis for quantity calculation)
Shopify variant GIDLinked product variant (added to the cart)

Flooring item form with fields filled in and the variant picker open

Selecting a variant

Use the variant picker to link the Shopify variant GID field to a real product variant. That variant is added to the cart on purchase – so price and inventory still run through your normal Shopify product.

Category-specific fields

  • Flooring: additionally Flooring type (handle) – an optional key to group flooring by type.
  • Substructure beam, start profile, end profile: additionally Material (WOOD, STEEL or ALU).
  • Substructure beam: additionally Max. span (mm) – the maximum allowable span. The configurator only selects beams that can carry the required span.

Tips

  • Maintain Width and Price per mm carefully – they drive quantity and price in the result.
  • Set Active to off to temporarily hide an item without deleting it.
  • After changes, verify the output in the configurator (see Using the configurator).