> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kwebby.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Product information

> The product page: the gallery, title and reference, price, metal and size choices with a size guide, engraving, gift options, buy buttons, pickup, trust badges and the details rows.

![Product information on the storefront](https://mintcdn.com/kwebby/Y7lUE3PaLXfHjaRp/images/vesper/main-product.webp?fit=max\&auto=format\&n=Y7lUE3PaLXfHjaRp\&q=85\&s=4ccf31ad490bc47f76ecabd478c83ea0)

Product information, highlighted with the demo content

## Where to find it

Every product that uses the default product template. In the theme editor choose Products, then Default product, and select Product information.

## How it works

* Desktop gallery layout can be Stacked, Two-column grid, Mosaic or Carousel with thumbnails. Phones always get a gallery to swipe through. The selected variant's image comes first.
* Image zoom gives a magnifier that follows the pointer and a lightbox where shoppers zoom further, or the lightbox only, or no zoom.
* Product videos play muted on a loop while visible, or with player controls. YouTube and Vimeo films load only after a click; 3D models get Shopify's viewer and View in your space.
* Up close shows three closer crops of the first image under the buy box. The worn gallery shows the images in the product metafield custom.worn.
* Changing a metal or size updates the price, stock line, buttons, pickup and images without reloading the page, keeps what the shopper typed, and updates the address bar.
* With Ask shoppers to choose a size on, no size is preselected and Add to bag asks for one.
* Pre-order products show a Pre-order button and their ship date note. Price on request products hide the price and show an enquiry button.
* The sticky add to bag bar appears once the main button scrolls out of view, on phones or on phones and desktop. The page makes room for it, so it never covers content.
* Up to one each of most blocks; add as many Text, Collapsible row and Custom Liquid blocks as you need.

![Product information in the theme editor](https://mintcdn.com/kwebby/ipMVAv6ECVUC3DoM/images/vesper/editor-main-product.webp?fit=max\&auto=format\&n=ipMVAv6ECVUC3DoM\&q=85\&s=613373e36a4c3d6a23fef54ac7215444)

In the theme editor: 1 the section in the sidebar · 2 its settings · 3 the section in the preview

## Edit it

* Drag blocks to reorder them. Keep Quantity directly above Buy buttons.
* In Variant picker, list your size option names under Size options (default Ring size, Size) and your metal option names under Metal options.
* Set a Size guide page, or fill the product metafield custom.size\_chart, to replace the built-in ring size table. Add a Ring sizer link if you send sizers.
* In Engraving choose Products marked engravable or All products, and set the Character limit.
* In Buy buttons choose the Enquiry page for price on request pieces (default: your contact page), and add an Extra link such as a private viewing page.
* In Product details turn rows on or off and rename them. Rows fill from product metafields and hide themselves when empty.
* Add app blocks for reviews or other apps from Add block, Apps.

## Settings

**Gallery**

| Setting | What it does |
| - | - |
| **Desktop gallery layout** | Options: Stacked, Two-column grid, Mosaic, Carousel with thumbnails. Phones always show a gallery to swipe through. Default: Stacked. |
| **Image zoom** | Options: Magnifier on hover and lightbox, Lightbox only, Off. The magnifier follows the pointer on desktop. A click opens the lightbox, where shoppers can zoom further. Default: Magnifier on hover and lightbox. |
| **Product videos** | Options: Play muted on a loop while visible, Show player controls. Muted loops never play with reduced motion or data saver on, and have a pause button. Default: Play muted on a loop while visible. |

**Galleries below**

| Setting | What it does |
| - | - |
| **Show "Up close" row** | On or off. Three closer crops of the product's first image. Default: on. |
| **"Up close" heading** | Text. Default: Up close. |
| **"Up close" text** | Text. Default: Three steps closer, from the same photograph. |
| **Show worn gallery** | On or off. Images from the product metafield custom.worn (list of files). Hidden when the metafield is empty. Default: on. |
| **Worn gallery heading** | Text. Default: Worn, and presented. |
| **Worn gallery link** | Link: a page, product, collection or web address. |
| **Worn gallery link label** | Text. Default: The gallery. |

**Details and page**

| Setting | What it does |
| - | - |
| **Product details layout** | Options: Collapsible rows, Tabs. Default: Collapsible rows. |
| **Show breadcrumbs** | On or off. Default: on. |
| **Sticky add to cart bar** | Options: Off, Phones, Phones and desktop. Appears once the main button scrolls out of view. The page makes room for it, so it never covers content. Default: Phones. |
| **Color scheme** | Color scheme for this area (edit the schemes in Theme settings → Colors). Default: Scheme 1. |

## Blocks

Add a block with **Add block** under the section in the sidebar; drag blocks to reorder them.

### App blocks

Blocks from apps you have installed, such as reviews or subscriptions. Click **Add block** and choose one from the Apps tab; its settings come from the app.

### Title (up to 1)

| Setting | What it does |
| - | - |
| **Show product badges** | On or off. Sold out, pre-order, sale, New and your custom.badge metafield. Set them in Theme settings, Product cards. Default: on. |
| **Line above the title** | Options: Collection, Vendor, Product type, None. Default: Collection. |
| **Show reference** | On or off. From the product metafield custom.reference. Default: on. |

### Price (up to 1)

| Setting | What it does |
| - | - |
| **Show saving beside sale prices** | On or off. Default: on. |
| **Show Shop Pay Installments** | On or off. Shopify shows it when Shop Pay Installments is on for your store and the price qualifies. Default: on. |
| **Show product badges** | On or off. Use this when the Title block's badges are off. Default: off. |
| **Price on request text** | Text. Default: Shown in the salon or by video. A client advisor will confirm the price. |
| **Gift card text** | Text. Default: Delivered by email. Never expires. |

**Sale countdown**

| Setting | What it does |
| - | - |
| **Sale end** | Text. Shown only on sale prices, until this moment. Use the end time of your real discount, as a date, time and UTC offset. Leave empty to turn it off. |
| **Countdown label** | Text. Default: Sale ends in. |

### Text

| Setting | What it does |
| - | - |
| **Text** | Options: Start of the product description, Subtitle metafield, Custom text. The subtitle is the product metafield custom.subtitle. Default: Start of the product description. |
| **Description words** | Slider from 10 to 60, in steps of 5. Default: 30. |
| **Custom text** | Formatted text. |
| **Style** | Options: Lead paragraph, Body text, Secondary text. Default: Lead paragraph. |

### Variant picker (up to 1)

| Setting | What it does |
| - | - |
| **Size options** | Text. Comma-separated option names shown as a grid of sizes with the size guide. Default: Ring size, Size. |
| **Metal options** | Text. Option names shown with a metal swatch. Swatches set on the option in Shopify are used first. Default: Metal, Material, Finish, Color. |
| **Ask shoppers to choose a size** | On or off. No size is preselected; Add to cart asks for one. Default: on. |
| **Other options** | Options: Buttons, Dropdown. Default: Buttons. |

**Size guide**

| Setting | What it does |
| - | - |
| **Show size guide** | On or off. Default: on. |
| **Size guide link label** | Text. Default: Size guide. |
| **Size guide page** | Choose a page. The product metafield custom.size\_chart (page) is used first. Without either, a ring size table is shown. |
| **Ring sizer link** | Link: a page, product, collection or web address. |
| **Ring sizer link label** | Text. Default: Request a free ring sizer. |

### Quantity (up to 1)

| Setting | What it does |
| - | - |
| **Show stock line** | On or off. "Only N left" follows Theme settings, Product cards, and real inventory. Otherwise shows the custom.lead\_time metafield or "In stock". Default: on. |

> [!TIP]
>
> Quantity price breaks appear here when a B2B catalog or volume pricing applies to the shopper.

### Engraving (up to 1)

| Setting | What it does |
| - | - |
| **Show for** | Options: Products marked engravable, All products. Mark a product with the true/false metafield custom.engravable. Saved as the line item property Engraving. Default: Products marked engravable. |
| **Character limit** | Slider from 4 to 40. Default: 12. |
| **Toggle label** | Text. Default: Add engraving, free. |
| **Offer lettering styles** | On or off. Roman capitals or script, saved as Lettering. Default: on. |
| **Show engraving preview** | On or off. Default: on. |
| **Note** | Text. Default: Engraved by hand; adds three working days. Engraved pieces cannot be returned. |

### Gift options (up to 1)

| Setting | What it does |
| - | - |
| **Checkbox label** | Text. Default: Gift presentation and a handwritten card, free. |
| **Show gift message** | On or off. Saved as the line item property Gift message. The checkbox is saved as the hidden property \_gift\_box. Default: on. |
| **Message length** | Slider from 50 to 250, in steps of 10. Default: 200. |

### Buy buttons (up to 1)

| Setting | What it does |
| - | - |
| **Show dynamic checkout button** | On or off. Buy it now with the payment methods you offer. Default: on. |
| **Show gift card recipient form** | On or off. Lets shoppers send a gift card to someone by email on a date they choose. Default: on. |

**Price on request**

| Setting | What it does |
| - | - |
| **Enquiry page** | Choose a page. Defaults to your contact page. The link carries the product, so the form can name it. |
| **Enquiry button label** | Text. Default: Enquire about this piece. |

**Extra link**

| Setting | What it does |
| - | - |
| **Link** | Link: a page, product, collection or web address. For example a page about private viewings. Leave empty to hide. |
| **Link label** | Text. Default: Prefer to see it first? Book a private viewing. |

### Back in stock alert (up to 1)

| Setting | What it does |
| - | - |
| **Text** | Text. Default: This choice is sold out. We can write when it is back. |

> [!TIP]
>
> Shown only for sold-out variants. Requests arrive in your store's inbox as contact messages.

### Pickup availability (up to 1)

> [!TIP]
>
> Shows the nearest location with local pickup and every other one in a drawer. Turn on local pickup in Settings, Shipping and delivery.

| Setting | What it does |
| - | - |
| **Advisor link** | Link: a page, product, collection or web address. Optional, for example your contact page. Also shown when no location offers pickup. |
| **Advisor link label** | Text. Default: Ask a client advisor. |

### Trust badges (up to 2)

| Setting | What it does |
| - | - |
| **Icon 1** | Options: None, Delivery, Shield, Return, Check, Lock, Gift, Spark, Location, Clock. Default: Delivery. |
| **Title 1** | Text. Default: Insured delivery. |
| **Text 1** | Text. Default: Signed for, in a lacquered case. |
| **Icon 2** | Options: None, Delivery, Shield, Return, Check, Lock, Gift, Spark, Location, Clock. Default: Shield. |
| **Title 2** | Text. Default: Lifetime care. |
| **Text 2** | Text. Default: Cleaning and claw checks, free. |
| **Icon 3** | Options: None, Delivery, Shield, Return, Check, Lock, Gift, Spark, Location, Clock. Default: Return. |
| **Title 3** | Text. Default: 30-day returns. |
| **Text 3** | Text. Default: Unengraved pieces, free collection. |
| **Icon 4** | Options: None, Delivery, Shield, Return, Check, Lock, Gift, Spark, Location, Clock. Default: Check. |
| **Title 4** | Text. Default: Secure checkout. |
| **Text 4** | Text. Default: Shop Pay, cards and PayPal. |

### Product details (up to 1)

> [!TIP]
>
> Rows or tabs (section setting) filled from product metafields. Rows with nothing to show are hidden.

| Setting | What it does |
| - | - |
| **Open the first row** | On or off. Default: on. |
| **Show description** | On or off. Default: on. |
| **Description heading** | Text. Default: Description. |
| **Show specifications** | On or off. From custom.specifications, one "Label: value" per line, plus the chosen options and the reference. Default: on. |
| **Specifications heading** | Text. Default: Details and dimensions. |
| **Show certificate** | On or off. From custom.certificate, for example "GIA 2141438071". Default: on. |
| **Certificate heading** | Text. Default: The stone and its report. |
| **Certificate text** | Formatted text. |
| **Certificate link** | Link: a page, product, collection or web address. |
| **Certificate link label** | Text. Default: How to read a grading report. |
| **Show materials** | On or off. From custom.materials. Default: on. |
| **Materials heading** | Text. Default: Materials and composition. |
| **Show care** | On or off. From custom.care, one tip per line, or the text below. Default: on. |
| **Care heading** | Text. Default: Care. |
| **Care text** | Formatted text. |
| **Show delivery** | On or off. From custom.delivery, or the text below. The custom.lead\_time metafield is added under it. Default: on. |
| **Delivery heading** | Text. Default: Delivery and returns. |
| **Delivery text** | Formatted text. |
| **Show gift presentation** | On or off. Default: on. |
| **Gift presentation heading** | Text. Default: Gift presentation. |
| **Gift presentation text** | Formatted text. |

### Collapsible row

| Setting | What it does |
| - | - |
| **Heading** | Text. Default: Collapsible row. |
| **Content** | Formatted text. |
| **Page content** | Choose a page. Added after the content above. |
| **Open by default** | On or off. Default: off. |

### Share buttons (up to 1)

| Setting | What it does |
| - | - |
| **Label** | Text. Default: Share. |

> [!TIP]
>
> Each button opens the network's own share page. No app or tracking script is added.

| Setting | What it does |
| - | - |
| **Email** | On or off. Default: on. |
| **Pinterest** | On or off. Default: on. |
| **Facebook** | On or off. Default: on. |
| **X** | On or off. Default: on. |
| **WhatsApp** | On or off. Default: on. |
| **Threads** | On or off. Default: on. |
| **Telegram** | On or off. Default: on. |
| **Copy link** | On or off. Default: on. |

### Custom Liquid

| Setting | What it does |
| - | - |
| **Custom Liquid** | Liquid code. Add app snippets or other Liquid code. |

> [!NOTE]
>
> Most rows and lines come from product metafields. See [Set up your products](https://docs.kwebby.com/gloaming/getting-started/set-up-products.md) and the [Metafields reference](https://docs.kwebby.com/gloaming/guides/metafields-reference.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.