Code safety Always duplicate your theme (Online Store → Themes → … → Duplicate) before editing any Liquid, CSS, or JSON code.

Chapter 02 · PDP & Collection Merchandising

Product pages & merchandising setup

Averdane’s product detail page (PDP) and collection cards are designed around how apparel is actually evaluated: silhouette at full length, cloth texture up close, colorways linked without clutter, and sizing or alteration context right above Add to bag.

Open any product template in the Theme Editor and click the Product information section:

2. Color-grouped media

When a garment comes in multiple colorways on a single product record, Averdane filters the gallery automatically when shoppers switch colors—without requiring third-party variant-image apps.

  1. In Shopify Admin → Products, open your product and click each media item to edit its Alt text.
  2. Start the image’s alt text with the exact color option value followed by a separator—for example: Tobacco — front, Tobacco — back, or Black — lapel detail. (Alternatively, assign the image directly as a variant’s main image.)
  3. Leave shared detail images (such as a care tag, interior construction shot, or packaging photo) without a color prefix so they remain visible across every selected color.

3. Video, 3D models, and zero-image fallback

4. Sibling products (“Also in this cut”)

Many fashion brands merchandise each colorway or fabric edition as its own separate Shopify product so every color gets its own URL, collection card, and gallery. Averdane connects those separate products into a seamless swatch strip inside the Variant picker block.

  1. In Settings → Custom data → Products, click Add definition:
    • Name: Sibling products
    • Namespace and key: custom.siblings
    • Type: Product → select List of products.
  2. On each sibling product, select the companion color/cloth products in the Sibling products metafield.
  3. In the Theme Editor under Product information → Variant picker, turn on Show sibling products and optionally customize Sibling products heading.

When shoppers hover a sibling thumbnail on desktop, Averdane previews that garment on the main gallery stage and swaps between sibling PDPs smoothly. If custom.siblings is left empty while Show sibling products is enabled, Averdane automatically pairs up to four garments sharing the same product type and department prefix.

5. Multi-size quick order & collection quick add

6. Product details, Complete the look, and Pickup availability

Product details section (Product details)

Below the primary buy zone, the Product details section pairs a macro Detail image (defaulting to the product’s final landscape image if left unset) with structured specification blocks:

Complete the look, Recommendations, Reviews & Local pickup