> ## 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.

# Featured product

> One product with its gallery and buy box on any page, using the same blocks as the product page.

![Featured product on the storefront](https://mintcdn.com/kwebby/Y7lUE3PaLXfHjaRp/images/vesper/featured-product.webp?fit=max\&auto=format\&n=Y7lUE3PaLXfHjaRp\&q=85\&s=2fbb833fc535cd6fc1d2f00ae60a76d8)

Featured product, highlighted with the demo content

## Where to find it

Not on a page by default. In the theme editor open the page where you want it, click Add section and choose Featured product.

## How it works

* Uses the same blocks as Product information: title, price, text, variant picker, quantity, engraving, gift options, buy buttons, pickup, trust badges, details and more.
* Gallery can be a carousel with thumbnails, slides with arrows, or stacked images. Phones always swipe.
* Show the gallery first on desktop puts the gallery on the left, or turn it off to put the information first.
* Without a product chosen, it shows a placeholder.

![The Add section list in the theme editor](https://mintcdn.com/kwebby/ipMVAv6ECVUC3DoM/images/vesper/editor-add-section.webp?fit=max\&auto=format\&n=ipMVAv6ECVUC3DoM\&q=85\&s=69f96310f9276a06f3d048d70b6f28af)

Not on the demo pages: add it with 1 Add section, then pick it in 2 the list

## Edit it

* Choose the Product.
* Choose Gallery, Image zoom and Product videos.
* Add, remove and reorder blocks as on the product page.

## Settings

| Setting | What it does |
| - | - |
| **Product** | Choose a product. |

**Gallery**

| Setting | What it does |
| - | - |
| **Gallery** | Options: Carousel with thumbnails, Slides with arrows, Stacked. Phones always show a gallery to swipe through. Default: Slides with arrows. |
| **Image zoom** | Options: Magnifier on hover and lightbox, Lightbox only, Off. Default: Lightbox only. |
| **Product videos** | Options: Play muted on a loop while visible, Show player controls. Default: Play muted on a loop while visible. |
| **Show the gallery first on desktop** | On or off. Turn off to put the information on the left (on the right in right-to-left languages). Default: on. |

**Details and section**

| Setting | What it does |
| - | - |
| **Product details layout** | Options: Collapsible rows, Tabs. Default: Collapsible rows. |
| **Color scheme** | Color scheme for this area (edit the schemes in Theme settings → Colors). Default: Scheme 2. |

## 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. |


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