Skip to content

Add a new Colourway

A new Colourway is a new product joined to its Model. Shopify doesn’t check that it’s set up correctly, so work through every step below. A Colourway that misses one can lose its Swatches, its Lens Tech cards or its place on listing pages.

Build it as a Draft and set it Active only at the end. You’ll need its product images and its Swatch Front Image: the front-on image without a shadow, used on its Swatch tile.

  1. Start from an existing Colourway of the same Model: Products → the Colourway → … → Duplicate. Then check every field below, because a copy can carry the wrong values over.

  2. Title: the Model’s title followed by the Colourway, e.g. Renegades™ Matte Black with Smoke. Handle: the same in lower case with dashes, e.g. renegades-matte-black-with-smoke.

  3. Product type, vendor and tags: the same as the other Colourways, e.g. Renegades, Lifestyle, Eyewear. Keep the _cl-child tag. Add the Model’s Badges if it has any.

  4. Images: upload the Colourway’s product images.

  5. Variants: one per Lens Tech, under the option Lens Tech (e.g. Standard, Polarised, 8KO, 8KO Polarised). For each, set the SKU, price, compare-at price, barcode, weight and stock.

  6. Template: leave it on Default product.

  1. On the product, under Metafields:

    • Combined Listing Parent: the Model’s parent product, e.g. Renegades™.
    • Base Product: the Model’s Base Product.
    • Custom Product: the Model’s Custom Shell Product, e.g. Custom Renegades™. This is where Build Your Own leads.
    • Swatch Front Image: the Swatch tile image.
    • The Filter Values: copy Category, Partner, Gender, Sport, Face Size, Face Shape and Product Category from another Colourway, then set Lens Colour and Frame Colour for this one.
  2. On each variant, under Metafields:

    • Lens Tech: the matching Lens Tech entry, e.g. 8KO Polarised.
    • Lens Specification: the entry for this lens colour. Other Colourways with the same lens already use it.
    • Variant Visibility: leave blank to offer it everywhere. See Hide or unlist a variant.
  1. In the Combined Listings app, open the Model’s listing and add the new product. Give it its product title as the Product value, like the others.

  2. On the parent product, add the new Colourway to its Swatches metafield, in the position its Swatch should take. See Swatches and the default Colourway.

  3. In Search & Discovery, choose its Related Items.

  4. Add it to any hand-picked collections. Collections with rules pick it up from its tags and Filter Values.

  5. Set the product Active and make sure it’s on the Online Store sales channel.

  • Open the Model’s page and switch to the new Swatch: the images, title and price change.
  • Select each Lens Tech: its card and the Technical Specification panel are right.
  • Build Your Own opens the Model’s customiser.
  • The Colourway appears on the listing pages it should, and with the right Badges.