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

# Filters with Search & Discovery

> Set up metal, stone, carat, length, ring size and price filters for collection and search pages, in the right order.

![The collection toolbar](https://mintcdn.com/kwebby/Y7lUE3PaLXfHjaRp/images/vesper/main-collection.webp?fit=max\&auto=format\&n=Y7lUE3PaLXfHjaRp\&q=85\&s=8ec70bdbfcfa7a4e2d851a6b479cbd75)

The collection toolbar: filters, chips, count, sort and density

Collection and search pages use the filters you set up in Shopify's free Search & Discovery app. Gloaming shows them in a drawer, or a sidebar on desktop, with metal swatches, stone chips and size boxes.

**1. Fill in the product data.** Create these product metafield definitions (namespace custom, Single line text) in Settings, Custom data, Products, and fill them in:

* custom.stone: the main stone, one value, for example Diamond, Emerald, Sapphire or Pearl;
* custom.stone\_shape: for example Round, Oval or Pear;
* custom.carat\_band: one band per value, for example 1.00 to 1.99 ct;
* custom.length: for necklaces and bracelets, for example 18 in;
* custom.certificate: the grading report.

Add custom.engravable as True or false.

**2. Add the filters in this order.** In the Search & Discovery app, open Filters and add:

1. Availability
2. Product type
3. Collection, if you keep a collection name in a product metafield
4. Metal (the variant option; give it swatches)
5. Stone (custom.stone)
6. Stone shape (custom.stone\_shape)
7. Carat weight (custom.carat\_band)
8. Chain or strand length (custom.length)
9. Price
10. Ring size (the variant option)
11. Certificate (custom.certificate)
12. Engravable (custom.engravable)
13. Sale (a tag or a true or false metafield; Shopify has no built-in on-sale filter)

![The filter drawer on a collection page](https://mintcdn.com/kwebby/Y7lUE3PaLXfHjaRp/images/vesper/guide-filters.webp?fit=max\&auto=format\&n=Y7lUE3PaLXfHjaRp\&q=85\&s=7488adbc52d023710e387ac739e5862f)

The filter drawer with metal swatches and stone chips

**How they look.**

* Metal shows as swatches, from Shopify's option swatches, or as yellow, white and rose dots drawn from the value names.
* Stone shows small gem chips for Diamond, Emerald, Sapphire, Pearl and Gold alone.
* Ring size shows as boxes, because Ring size is listed in Filters shown as size boxes.
* True or false filters, such as Engravable, show as switches under More.
* Values with no matching pieces are disabled, not hidden.

**Section settings.** In the Collection and Search results sections, choose Filter layout on desktop (Drawer or Sidebar), Filter groups open at first, and Price shortcuts such as 3000, 10000, which add Under 3,000, 3,000 to 10,000 and Over 10,000 under the price filter.

**Sorting.** Sorting uses Shopify's own options: Featured, Best selling, Alphabetically, Price and Date, plus Relevance on search.

## In the theme editor

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

Filtering, sorting and the collection navigation: 1 Collection · 2 its settings · 3 the preview


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