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

# Metafields reference

> Every product and blog post metafield Gloaming reads, its type, and where it shows.

All are optional: Gloaming works with none of them, and each row or line simply hides when its metafield is empty. Create the definitions in Settings, Custom data, with the namespace custom and storefront access on, then fill them in on each product or post.

**Products**

| Metafield | Type | Where it shows |
| - | - | - |
| `custom.subtitle` | Single line text | The line under the title on product cards and in quick view, for example 18k yellow gold, 0.50 ct diamond. Without it, cards show the metal and stone. Also a Text block source on the product page. |
| `custom.reference` | Single line text | Ref. under the product title, and the Reference row in the details. |
| `custom.specifications` | Multi-line text | Details and dimensions, one Label: value per line. |
| `custom.certificate` | Single line text | The stone and its report, for example GIA 2141438071. Also a filter. |
| `custom.materials` | Multi-line text | Materials and composition. |
| `custom.care` | Multi-line text | Care, one tip per line. Falls back to the block text. |
| `custom.delivery` | Multi-line text | Delivery and returns. Falls back to the block text. |
| `custom.lead_time` | Single line text | The stock line when stock is not low, and under Delivery, for example Made to order in 4 weeks. |
| `custom.preorder_note` | Single line text | Above the Pre-order button, and on the order. |
| `custom.stone` | Single line text | The stone buttons in Featured collection, card data and the Stone filter. One value, for example Diamond. |
| `custom.stone_shape` | Single line text | The Stone shape filter. |
| `custom.carat_band` | Single line text | The Carat weight filter, one band per value. |
| `custom.length` | Single line text | The Chain or strand length filter. |
| `custom.engravable` | True or false | Shows the Engraving block; also a filter. |
| `custom.price_on_request` | True or false | Hides the price and shows the enquiry button. |
| `custom.badge` | Single line text | A label on cards and the product page, for example One of a kind. |
| `custom.worn` | List of files | The worn gallery under the buy box. |
| `custom.size_chart` | Page reference | The page shown in the size guide drawer. |

**Blog posts (Events blog)**

| Metafield | Type | Where it shows |
| - | - | - |
| `custom.start` | Date and time, or single line text | The event's start, for example 2026-11-20T19:00-05:00. Also the date badge in the Boutique and event section. |
| `custom.end` | Date and time, or single line text | The event's end. |
| `custom.location` | Single line text | The place, for example New York. Links to the boutique with that city. |
| `custom.event_type` | Single line text | The kind, for example Trunk show. |

**From Shopify and its apps**

| Source | Used for |
| - | - |
| Color category metafield on the Metal option | Metal swatches on cards, the product page and filters. See [Metal swatches](https://docs.kwebby.com/gloaming/guides/metal-swatches.md). |
| Search & Discovery complementary products | Complete the set on the product page and Goes well with in the bag. |
| Variant quantity rules and price breaks (B2B catalogs) | The quantity stepper, the price breaks table and the quick order list. |

**Line item properties and cart attributes saved on orders**

| Name | From |
| - | - |
| Engraving, Lettering | The Engraving block |
| Gift message (line) | The Gift options block |
| \_gift\_box | The Gift options checkbox (hidden in the cart) |
| Pre-order | The pre-order note |
| Gift message (cart attribute) | Theme settings, Cart, Show gift message |


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