| 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. |
| 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. |
| Source | Used for |
|---|---|
| Color category metafield on the Metal option | Metal swatches on cards, the product page and filters. See Metal swatches. |
| 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. |
| 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 |