For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

Reviews integration

DRIFT Pro reads reviews.rating and reviews.rating_count automatically when present. These metafields are populated by the Shopify Product Reviews app (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 → SettingsCustom 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.

Last updated