> For the complete documentation index, see [llms.txt](https://docs.webexp.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.webexp.dev/drift-shopify-theme/drift-pro/metafields.md).

# Metafields

How to use the metafields DRIFT Pro supports.

Metafields are extra data you attach to products, beyond the standard title/price/description. DRIFT Pro uses a small set of custom metafields, plus reads ratings from the Shopify Reviews app if installed.

## What metafields DRIFT Pro uses

| Metafield              | What it does                                                                    | Type                          |
| ---------------------- | ------------------------------------------------------------------------------- | ----------------------------- |
| `custom.size_chart`    | Shows a size chart image in a modal on the PDP                                  | File → Image                  |
| `custom.is_preorder`   | Changes the ATC button label to your pre-order text                             | Boolean (true/false)          |
| `custom.preorder_text` | Text that replaces "Add to Cart" when pre-order is on (defaults to "Pre-Order") | Single line text              |
| `custom.sold_out_text` | Replaces the words "Sold Out" on that product, e.g. "Coming Soon"               | Single line text              |
| `reviews.rating`       | Star rating shown on product cards and PDP                                      | Rating (Shopify Reviews app)  |
| `reviews.rating_count` | Number of reviews next to the rating                                            | Integer (Shopify Reviews app) |

## Detail pages

* [**Size Chart**](/drift-shopify-theme/drift-pro/metafields/size-chart.md) — modal-based size guide on the PDP
* [**Pre-Order**](/drift-shopify-theme/drift-pro/metafields/preorder.md) — relabel the ATC button as Pre-Order
* [**Sold Out Text**](/drift-shopify-theme/drift-pro/metafields/sold-out-text.md) — say "Coming Soon" instead of "Sold Out"

## Reviews integration

DRIFT Pro reads `reviews.rating` and `reviews.rating_count` automatically when present. These metafields are populated by the [Shopify Product Reviews app](https://apps.shopify.com/product-reviews) (or any reviews app that writes to the same namespace and keys). Install the app, collect reviews, and the rating displays on product cards and the PDP without any theme changes.

## How to set up a metafield in Shopify

You only do this once per metafield, then any product can use it.

1. Open Shopify admin → **Settings** → **Custom data**
2. Pick **Products**
3. Click **Add definition**
4. Fill in:
   * **Name** — human-friendly name (e.g., "Size Chart")
   * **Namespace and key** — must match exactly what DRIFT expects (see each metafield page)
   * **Type** — must match (File → Image, Boolean, Single line text — see each metafield page)
5. Save

Now go to any product. Scroll to the bottom of the product page in admin. You'll see a **Metafields** section where you can fill in values per product.

## Heads up on namespace and key

DRIFT looks for metafields under the `custom` namespace (Shopify's default for store-managed metafields). The keys must be exactly:

* `custom.size_chart`
* `custom.is_preorder`
* `custom.preorder_text`

If you use a different namespace or misspell the key, the theme won't find the value and the feature won't activate. No error message — it just silently doesn't show.

## Bulk editing

If you have hundreds of products, editing metafields one at a time isn't realistic. Two options:

* **Shopify's bulk editor** — Products → select multiple → Bulk edit → add the metafield column
* **Matrixify or Excelify apps** — CSV import/export of metafields

Both work fine with DRIFT.

## On product badges

DRIFT Pro renders an automatic sale badge on products where `compare_at_price` is higher than the regular price. There is no custom badge metafield in Pro — the sale badge is the only badge. To control whether a product shows a sale badge, set or unset its compare-at price in the product editor.