> For the complete documentation index, see [llms.txt](https://nextsky.gitbook.io/purity-theme/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nextsky.gitbook.io/purity-theme/theme-installation/create-required-metafields/metafields.md).

# Metafields

Point Purity's content features at your own metafields, without editing code.

## Metafield settings

Several sections and blocks in Purity read their content from **metafields** on your products and collections. In Purity 1.3.0 the metafield each feature reads is a **setting you can change**, not a fixed value in the code. This means you can point any of these features at your own metafield (any namespace and key) without editing the theme.

### How it works

Each of these settings is a text field where you enter the metafield in `namespace.key` format, for example `custom.highlights`.

{% hint style="info" %}

* Leave the field on its **default** value to use the metafield Purity expects out of the box.
* Change it to any `namespace.key` if your store stores that content in a different metafield.
* The metafield must hold the type of content the feature expects (for example, a list of products, or a list of image/text items). Create the metafield in **Settings -> Custom data** if you don't have it yet.
  {% endhint %}

### Blocks

These are product blocks, added inside a product section or a section that supports blocks. They read from **product** metafields.

| Setting (block)                                 | Default metafield          |
| ----------------------------------------------- | -------------------------- |
| **Short description metafield** (Description)   | `custom.short_description` |
| **Highlights metafield** (Highlights)           | `custom.highlights`        |
| **Key features metafield** (Key features)       | `custom.key_features`      |
| **Media lightbox metafield** (See it in action) | `custom.media_lightbox`    |
| **Model size metafield** (Model size)           | `custom.model_size`        |
| **Product sizing metafield** (Product sizing)   | `custom.product_sizing`    |
| **Shop the look metafield** (Shop the look)     | `custom.shop_the_look`     |

### Sections

| Setting (section)                                                   | Reads from | Default metafield                   |
| ------------------------------------------------------------------- | ---------- | ----------------------------------- |
| **Similar products metafield** (Shop similar product)               | Product    | `custom.similar_products`           |
| **Frequently bought together metafield** (Bought together products) | Product    | `custom.frequently_bought_together` |
| **Complete the look metafield** (Complete the look)                 | Product    | `custom.complete_the_look`          |
| **Info gallery metafield** (Key ingredients)                        | Product    | `custom.info_gallery`               |
| **Compare items metafield** (Compare products)                      | Product    | `custom.compare_items`              |
| **Ingredient highlights metafield** (Compare products)              | Product    | `custom.ingredient_highlights`      |
| **Subcollection metafield** (Sub collection)                        | Collection | `custom.subcollection`              |

### Theme settings

| Setting                                                        | Reads from | Default metafield                  |
| -------------------------------------------------------------- | ---------- | ---------------------------------- |
| **Scrolling text metafield** (Theme settings -> Product cards) | Product    | `custom.highlights_scrolling_text` |
| **Collection empty metafield** (Theme settings -> Cart)        | Collection | `custom.collection_empty`          |