Glossary
This guide uses these words in exactly these senses. Where a word is easy to confuse with another, the entry says so.
Products
Section titled “Products”Model : A frame design, sold in several colours, e.g. Renegades or Velans.
Colourway : One frame colour and lens colour combination of a Model, e.g. Grey Fire. Each Colourway is its own product in Shopify.
Combined Listing : The Shopify feature that groups a Model’s Colourways under one parent product, so shoppers can switch colour without leaving the page.
Standalone Sunglass : A sunglass product that isn’t in a Combined Listing, usually an older or clearance product with no sibling Colourways.
Lens Tech : The lens technology, e.g. Standard, Polarised or 8KO Polarised. Each one is a variant of a Colourway, and its card content (name, subtitle, features) is a Lens Tech metaobject.
Base Product : A Base Product metaobject holding everything a Model’s Colourways share: description, specification, sizing, activities, features, upsells and In The Box. There’s one per Model, and each Colourway links to it.
Variant Visibility : Where a variant is offered: default (everywhere its product shows), unlisted (only where a specific placement offers it, never on its product page) or hidden (nowhere). It doesn’t stop a variant being bought; stock does that.
Product Feature : One selling point shown on a product page as an icon and a short phrase, e.g. “100% UV Protection”. Features are shared between Models and can be limited to certain Lens Techs.
Badge
: A short label on a product, e.g. New or Bestseller, added as a product tag that starts
Badge:. Badges show on product cards.
Ways to buy
Section titled “Ways to buy”Prebuilt : A ready-made product: one Colourway with one Lens Tech.
Custom : A pair the shopper builds themselves, choosing each part (frame, lenses, icons) in the customiser.
Lens Replacement Kit : Spare lenses for a Model, bought on their own and chosen in the customiser.
Parts Kit : A replacement part other than lenses, e.g. a goggle strap or Earsocks, chosen in the customiser.
Frame Kit : The extra parts for building a Pace Model a second way, bought alongside it.
Shell Product : The product that defines a Custom pair or a kit: which parts it offers and how they’re shown. A Shell Product is never in the cart itself; the parts the shopper picks are.
Component Product : A product for one individual part, e.g. a frame or a lens. It stays Unlisted, so it never shows in collections or search; it’s only bought through the customiser.
The customiser
Section titled “The customiser”Part : One choice in the customiser, e.g. a lens colour. A Product Part metaobject linking to the part’s product variant and its images.
Part Group : A row of Parts under one heading, e.g. Lenses. A Product Part Group metaobject.
Part Swatch : The colour circle for one Part in the customiser. Not the same as the product page’s Swatches.
Follower Part : A Part the shopper doesn’t choose: it’s picked automatically to match another Part, e.g. a Nose Piece that matches the frame.
Frame Type : One way a Pace Model is built, e.g. with a Zero Frame or a Base Frame. The shopper picks one in the customiser.
Ghost : Faded images behind a kit’s parts, showing what they fit, e.g. a frame behind spare lenses.
Match to Lenses : A link on the customiser’s icons row that makes the icon colour follow the chosen lens colour.
Product pages
Section titled “Product pages”Buy Box : The choices above Add To Bag: the Swatches, Options, Build Your Own, Lens Tech and the Shipping Timer.
Swatches : The colour picker in the Buy Box, one Swatch per Colourway of the Model. The list, in order, is kept in the parent product’s Swatches metafield.
Options : The Buy Box’s rows of choices other than colour and Lens Tech, e.g. a sock’s Size.
Upsell Slot : A named place for an add-on: Case, Lens Cleaning Kit, Microfibre, Care Bundle, Others and Lens Replacement Kit. Set on the Base Product, and can be replaced on a single product.
Add-ons : The cards below Add To Bag that offer the products in a product’s Upsell Slots.
Related Items : The carousel of other products on a product page, chosen in Search & Discovery.
Listing pages
Section titled “Listing pages”PLP : A product listing page. Each one is a Shopify collection.
Model page / Colourway page : A PLP showing one card per Model, with colour swatches, or one card per Colourway. Which it is depends on which products the collection holds.
Product Card : A product’s tile in a listing or carousel: image, name, price and Badges.
Quick Add : The eye button on a Product Card, which opens the product’s Buy Box in a pop-up.
Filter Links : The row of links to other PLPs under a PLP’s title. Not the same as Filters.
Filter : A control shoppers use to narrow a PLP, e.g. by Lens Colour. Set up in Search & Discovery.
Filter Value : One value a product is grouped by, e.g. the partner McLaren. Kept in the Filter: metaobjects and set on each product. Collection rules and Filters both use them.
PLP Banner : The banner above a PLP’s products. A PLP Banner metaobject, so one banner can serve many pages.
PLP Card Carousel : A carousel of content cards placed among a PLP’s products. Up to three per PLP.
Across the site
Section titled “Across the site”Partner logos : The certification and partnership badges in the promo bar and navigation. Kept in the Partnerships metaobject.
Localisation Sidebar : The panel that opens from the country and currency control, e.g. “US / USD”, to switch country.
Pretitle : The small line of text above a heading.