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

> Products from one collection as a grid of cards, with optional stone buttons that filter the pieces shown.

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

Featured collection, highlighted with the demo content

## Where to find it

Home page. In the theme editor choose Home page, then select Featured collection.

## How it works

* Shows 2 to 16 products from the chosen collection in 3 or 4 columns on desktop and 2 on phones.
* Stone buttons are built from the product metafield custom.stone of the products shown, such as Diamond, Emerald or Pearl. They appear only when there are at least two different stones.
* Products without a stone are grouped under the Label for products without a stone (Gold alone by default).
* Filtering happens in place, with a count of the pieces shown and a reset when nothing matches.

![Featured collection in the theme editor](https://mintcdn.com/kwebby/ipMVAv6ECVUC3DoM/images/vesper/editor-featured-collection.webp?fit=max\&auto=format\&n=ipMVAv6ECVUC3DoM\&q=85\&s=aedf73a270e683fa9e4ee3f31baa7843)

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

## Edit it

* Choose the Collection and set Products to show and Columns on desktop.
* Fill in custom.stone on your products to get the stone buttons. See [Metafields reference](https://docs.kwebby.com/gloaming/guides/metafields-reference.md).
* Turn off Show stone filter to hide the buttons.
* Edit Heading, Link label and Link. The link defaults to the collection.

## Settings

| Setting | What it does |
| - | - |
| **Color scheme** | Color scheme for this area (edit the schemes in Theme settings → Colors). Default: Scheme 1. |
| **Heading** | Text. Default: The edit. |
| **Collection** | Choose a collection. |
| **Products to show** | Slider from 2 to 16. Default: 8. |
| **Columns on desktop** | Options: 3, 4. Default: 4. |
| **Link label** | Text. Default: Shop all jewellery. |
| **Link** | Link: a page, product, collection or web address. Defaults to the collection. |

**Stone filter**

| Setting | What it does |
| - | - |
| **Show stone filter** | On or off. Buttons that filter the products shown here by the product metafield custom.stone (single line text, such as Diamond). They appear when the products have at least two different values. Default: on. |
| **Label for products without a stone** | Text. Leave empty to show no button for products without a stone. Default: Gold alone. |


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