Skip to content

How products fit together

A pair of sunglasses or goggles on the store isn’t one product in the admin. Knowing which piece holds what tells you where to make a change.

Every Model, e.g. Renegades, is made of three kinds of thing:

  • The parent product, e.g. Renegades™. It owns the Model’s page, /products/renegades, and groups the Colourways into a Combined Listing. It’s tagged Combined Listing and can’t be bought itself.
  • One product per Colourway, e.g. Renegades™ Matte Grey with Fire. These are what shoppers buy. Each is tagged _cl-child, and its Combined Listing Parent metafield points back to the parent.
  • One Base Product, under Content → Metaobjects → Base Product. It holds what every Colourway shares: description, specification, sizing, features, upsells and In The Box. Each product of the Model links to it in its Base Product metafield. See Base Product content.

A Colourway’s variants are its Lens Techs, e.g. Standard, Polarised and 8KO Polarised. Each variant links to a Lens Tech entry for its card on the product page, and to a Lens Specification entry for the lens details. See Lens Tech cards.

To change… Edit
Something every Colourway of a Model shares The Base Product
One Colourway’s images, price, stock or Badges That Colourway’s product
A Lens Tech’s price, stock or visibility on one Colourway That variant of the Colourway product
The order of the colour Swatches The parent product’s Swatches metafield; see Swatches and the default Colourway
A Model-wide Badge The parent and every Colourway; see Badges
  • Standalone Sunglasses are single Colourway products with Lens Tech variants and no parent, usually older or clearance products.
  • Accessories such as cases, microfibres and care bundles are grouped the same way as Models: a parent product with one product per accessory.
  • Simple products, such as socks, are one product whose choices are its own options, e.g. Size.
  • Custom pairs and kits are built in the customiser. Each has a Shell Product, e.g. Custom Renegades™ or Renegades™ Lens Replacement Kit, and its parts are Component Products.