How to setup Metafield in version 1.3.0?

From version 1.3.0, the sections and blocks that display metafield content no longer read a fixed, hard-coded key. Each one now has a Metafield setting where you type the metafield in namespace.key format. You can keep the theme's default key, or point the setting at any metafield you like.

Why this is useful

1. Use the same block more than once on a page, each with different content. Because the key is a setting, you can add the same block several times on one page and give each copy its own metafield. For example, one Highlights block can read custom.highlights while a second Highlights block on the same page reads custom.highlights_2, so each shows different content. With a fixed key, every copy would show the same thing.

2. Name the metafield to suit you. Create the metafield under your own naming convention (useful for agencies and brands, for example mybrand.highlights) and point the setting at it, or simply keep the theme's default key and change nothing.

How it works

Each feature below has a Metafield setting: a text field where you enter the metafield as namespace.key, for example custom.highlights.

• Keep the default (shown on each setup page) to use the metafield Purity expects out of the box. You don't have to type anything.

• Enter your own namespace.key if your content lives in a different metafield, then create that metafield in Settings -> Custom data.

• The metafield must hold the type of content the feature expects (see its setup page for the exact type).

Example: two of the same block on one page

1. In Settings -> Custom data, create two metafields, for example custom.highlights and custom.highlights_2, and fill each with different content on your product.

2. On the product page, add two Highlights blocks.

3. Leave the first block's Metafield as custom.highlights; set the second block's Metafield to custom.highlights_2.

4. Each block now shows its own content.

Example: rename for your brand

1. Create the metafield under your own name, for example mybrand.compare_items.

2. Open the Compare products section and set Compare items metafield to mybrand.compare_items.

3. The section now reads your metafield instead of the default.

Where the Metafield setting appears

Each row links to the page that shows how to create that metafield or metaobject. The default key is what the feature uses if you leave the setting unchanged.

Product blocks

Block	Metafield setting	Default metafield
Description	Short description metafield	custom.short_description
Highlights	Highlights metafield	custom.highlights
Key features	Key features metafield	custom.key_features
See it in action	Media lightbox metafield	custom.media_lightbox
Model size	Model size metafield	custom.model_size
Product sizing	Product sizing metafield	custom.product_sizing
Shop the look	Shop the look metafield	custom.shop_the_look

Sections

Section	Metafield setting	Default metafield
Shop similar product	Similar products metafield	custom.similar_products
Bought together products	Frequently bought together metafield	custom.frequently_bought_together
Complete the look	Complete the look metafield	custom.complete_the_look
Key ingredients	Info gallery metafield	custom.info_gallery
Compare products	Compare items metafield	custom.compare_items
Compare products	Ingredient highlights metafield	custom.ingredient_highlights
Sub collection	Subcollection metafield	custom.subcollection

Theme settings

Location	Metafield setting	Default metafield
Theme settings -> Product cards	Scrolling text metafield	custom.highlights_scrolling_text
Theme settings -> Cart	Collection empty metafield	custom.collection_empty