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

# Set up your products

> Metal and size options, metafields, badges, stock and photographs.

Gloaming reads a few details from your products to show metal swatches, sizes, stones, certificates and care notes. They are optional: products without them still work, and every line or row hides when it is empty.

## Options

Give each product its options in this order:

1. **Metal**, for example 18k yellow gold, 18k white gold, 18k rose gold, Platinum. Link it to the Color category metafield for swatches; see [Metal swatches](https://docs.kwebby.com/gloaming/guides/metal-swatches.md).
2. **Ring size** or **Size**, if it has one, with one value per size. See [Ring sizes and the size guide](https://docs.kwebby.com/gloaming/guides/ring-sizes-and-size-guide.md).

![Metal and size choices on the product page](https://mintcdn.com/kwebby/Y7lUE3PaLXfHjaRp/images/vesper/guide-metal-swatches.webp?fit=max\&auto=format\&n=Y7lUE3PaLXfHjaRp\&q=85\&s=8beb5f7d4462a3d3de735ebbbb41f1b0)

Metal swatches and ring sizes on the product page

## Create the custom fields once

In **Settings → Custom data → Products**, add these definitions with namespace `custom` and storefront access on. Start with the ones you need; the [Metafields reference](https://docs.kwebby.com/gloaming/guides/metafields-reference.md) lists every one.

| Name | Key | Type | Used for |
| - | - | - | - |
| Card line | `subtitle` | Single line text | The line under the title on cards, such as 18k yellow gold, 0.50 ct diamond. |
| Reference | `reference` | Single line text | Ref. under the product title. |
| Specifications | `specifications` | Multi-line text | Details and dimensions, one Label: value per line. |
| Certificate | `certificate` | Single line text | The stone and its report. |
| Stone | `stone` | Single line text | Stone buttons and the Stone filter, such as Diamond. |
| Lead time | `lead_time` | Single line text | Ready to ship, or Made to order in 4 weeks. |
| Engravable | `engravable` | True or false | Shows the engraving field. |
| Price on request | `price_on_request` | True or false | Hides the price and shows an enquiry button. |
| Badge | `badge` | Single line text | A label on cards, such as One of a kind. |

## Fill them in

Open a product and scroll to **Metafields** to fill in each field. For the multi-line fields, put one item per line.

## Badges and stock

* **Sale:** set a **Compare-at price** higher than the price. Cards show the sale badge chosen in **Theme settings → Product cards → Sale badge**.
* **New:** set **New badge for products published in the last** to a number of days. It is off (0) on install.
* **Only N left:** set **Show "Only N left" at or below** to 1, 2 or 3. It reads the real inventory of tracked variants and is off (0) on install.
* **Pre-order** and **Price on request:** see [Pre-order](https://docs.kwebby.com/gloaming/guides/pre-order.md) and [Price on request](https://docs.kwebby.com/gloaming/guides/price-on-request.md).

## Photographs and films

* Use the same shape for every product photograph, ideally portrait 4:5. Cards crop to **Theme settings → Product cards → Image shape**.
* The first photograph is used for the **Up close** row, so make it sharp and well lit.
* Product videos and 3D models go in the product's media like photographs. The product page plays videos muted on a loop or with controls, set in Product information.
* For the worn gallery, add a product metafield `custom.worn` of type **List of files** and add photographs of the piece being worn.


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