> 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-starter/metafields.md).

# Metafields

How metafields are used (and not used) in DRIFT Starter.

Metafields are extra data you attach to products beyond the standard title/price/description. DRIFT Starter keeps this deliberately light — one custom metafield, plus the review fields it reads automatically.

## What metafields DRIFT Starter reads

| Metafield              | What it does                                                      | Type                          |
| ---------------------- | ----------------------------------------------------------------- | ----------------------------- |
| `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 page:

* [**Sold Out Text**](/drift-shopify-theme/drift-starter/metafields/sold-out-text.md) — say "Coming Soon" instead of "Sold Out"

## Reviews integration

DRIFT Starter 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.

No setup is required in DRIFT itself — install the app and the values flow in.

## On product badges

DRIFT Starter renders an automatic sale badge on products where `compare_at_price` is higher than the regular price. There is no custom badge metafield in Starter — 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.
