Documentation/ Features /Metafields
Contact us
Install
05GENERAL

Metafields

Create the exact metafields read by the shared codebase and distinguish built-in keys, configurable keys, and data supplied by Shopify or an app.

WHAT IT DOES

Metafields

Create the exact metafields read by the shared codebase and distinguish built-in keys, configurable keys, and data supplied by Shopify or an app.

SHOPIFY WORKFLOW

Create a product metafield and enter its value

A definition creates the field for every product. Its value is then entered separately on each relevant product.

  1. 01

    In Shopify admin, open Settings → Metafields and metaobjects.

  2. 02

    Under Metafield definitions, choose Products. Choose Variants only when the code explicitly expects a variant metafield.

  3. 03

    Click Add definition.

  4. 04

    Enter a readable name, such as “Product features”.

  5. 05

    Under Namespace and key, enter the exact key expected by the theme. For product_features, the complete value must be custom.product_features. Do not replace custom or translate the key.

  6. 06

    Click Select type, then choose the type documented on this page. Example: List of single-line text values for custom.product_features.

  7. 07

    Keep the definition pinned if you want it readily available on product pages, then save.

  8. 08

    Open Products and select the product to complete. Scroll to Metafields or Custom data.

  9. 09

    Open the new field, enter or select its value, then save the product.

  10. 10

    Repeat for every product that should display the information, then check a real storefront page.

KEYS BUILT INTO THE CODE

Metafields to create with these exact names

These keys are read directly by the shared codebase. Another key will not be recognized unless a fallback is explicitly listed.

Glass Product Card

custom.material_badgeSingle-line text

Displays the material as a badge. When empty, the theme tries custom.matiere, then custom.material. Only one primary definition is required.

Glass Product Card

custom.product_featuresList of single-line text values

Displays each value as a separate product feature, up to the limit selected in the section.

Cart and cart drawer

custom.cart_badgeSingle-line text

Adds a product-specific badge such as “Limited edition” or “Made to order”.

Cart and cart drawer

custom.shipping_noteSingle-line text

Adds a product-specific shipping note, such as a lead time or separate shipment.

Shop the Look

custom.lot_item_1 · custom.lot_item_2 · custom.lot_item_3Product reference

Connects up to three products to the main product. The bundle template reads the same keys from the selected bundle product.

Virtual assistant

opaline.fitSingle-line text

Describes the fit. When missing, the assistant uses the section fallback setting.

Virtual assistant

opaline.stretchSingle-line text

Describes stretch. When missing, the assistant uses the section fallback setting.

Virtual assistant

opaline.size_chartJSON

Provides measurement ranges to the assistant. JSON may include label, bustMin/bustMax, waistMin/waistMax, and the other measurements expected by the guide. Size blocks are used as fallback.

Showroom Hotspots

custom.materials · custom.materialCompatible text

Displays material in the product modal. custom.material is used when custom.materials is empty.

Showroom Hotspots

custom.colorSingle-line text

Displays color in the product modal when Metafields is enabled.

Showroom Hotspots

custom.collectionSingle-line text

Displays the collection name in the product modal when Metafields is enabled.

Eloa preset — Detail Explorer

custom.image_details_1/2/3File — image

Provides the image for each of the three detail entries used by the Eloa product template.

Eloa preset — Detail Explorer

custom.category_details_1/2/3Single-line text

Provides the eyebrow or category for each of the three entries.

Eloa preset — Detail Explorer

custom.title_details_1/2/3Single-line text

Provides the title for each of the three entries.

Eloa preset — Detail Explorer

custom.full_description_details_1/2/3Rich text

Provides the full description for each entry and is rendered through metafield_tag.

SHOPIFY AND APPS

Data not to recreate as custom fields

Product reviewsreviews.rating · reviews.rating_count

The Glass Product Card and product page read these standard metafields. They should normally be populated by a compatible Shopify reviews app, not entered manually.

Shopify category attributesproduct.metafields.shopify

They come from the category assigned to the product. Select the correct Shopify category and complete its attributes; do not create a custom namespace called shopify.

MERCHANT-SELECTED KEYS

Metafields configured in the editor

  • 01

    The product page Category metafields block accepts a namespace and up to four keys, so it does not depend on a fixed custom key.

  • 02

    The Comparison Builder can use a metafield as a criterion. Every compared product must use the same namespace, key, and data type.

  • 03

    Blog Grid and Blog Discovery can rank articles using a likes counter. The article namespace and key are entered in the section settings.

CHECKS

Before you finish

  • ✓

    Content remains readable in every color scheme.

  • ✓

    Labels match the storefront language.

  • ✓

    Displayed promotions match Shopify rules.

  • ✓

    Interactions remain accessible by keyboard and touch.