How to Set Up Product Metafields

In this article, we will guide you through how to display product metafields on an Ecombe page.

Overview

Product metafields are custom data fields in Shopify that allow you to store and display additional product information beyond the default fields such as product name, price, description, or images.

Metafields are commonly used to manage product-specific data, for example: materials, size charts, usage instructions, technical specifications, videos, or custom marketing content.

By using product metafields, you can:

• Organize product data in a flexible and structured way

• Easily connect data with Ecombe Page Builder to display the right content in the right place

• Reduce manual updates when managing information across multiple products

In short, Product Metafields help you extend product data management and display product information in a more professional and consistent way across your store.

How to Display Product Metafields with Ecombe Featured Product

You can display Product Metafields in Ecombe Featured Product whether you already have Metafields created or you need to set them up from scratch.

Before proceeding, make sure that:

• The Product Metafield already exists in Shopify

• The Metafield has been assigned a value to the Product

• You have the correct Metafield key (namespace.key)

If you already have product Metafields set up, you can Use Existing Product Metafields and move directly to Connect the Product Metafield to Ecombe Featured Product.

Use Existing Product Metafields

If your already has product metafields:

1. Go to Shopify Admin → Settings → Metafields and metaobjects → Products

2. Open the existing Metafield definition you want to use

3. Copy the Metafield key

4. Make sure the Metafield has a value assigned to the product

5. Proceed to Connect the Product Metafield to Ecombe Featured Product

Set Up New Product Metafields via Shopify Admin

If you don’t have Product Metafields yet, follow the steps below to create one before connecting it to Ecombe Featured Product.

1

Access Product Metafield Definitions

Go to Shopify Settings → Metafields and metaobjects → Products

2

Set Up a New Product Metafield

On the Product metafield definitions page, click Add definition to create a new metafield.

In the Add product metafield definition screen, enter the required information such as Name, Type, and Category assignments (optional). Click Save to store your settings.

3

Get the Metafield Key

After successfully creating the metafield, Shopify will generate the Metafield namespace and key for you.

By default, the format is namespace.key. You will need to enter this exact key in Ecombe Featured Product.

4

Assign the Metafield to a Product

Once the metafield is created, you need to assign it to a product.

Go to Products in Shopify Admin, open a product, then scroll down to the Product Metafields section and enter the value for the Metafield.

Connect the Product Metafield to Ecombe Featured Product

Once the metafield is ready (existing or newly created):

1. Open the page in Ecombe Page Builder

2. Add or select the Collapsible content element

3. Enter the exact metafield key (namespace.key) into the corresponding metafield field

4. Save and publish the page

The product metafield content will now be displayed in the Ecombe Featured Product.

Result

After completing the steps above, the product metafield will be successfully displayed in the Ecombe Featured Product.

Common Issues

1. Product metafield does not display in Ecombe Featured Product

Possible causes:

• The metafield has not been assigned a value for the product

• The metafield key (namespace.key) is entered incorrectly

• The metafield type is not compatible with the element being used

How to fix:

• Check the product in Shopify Admin and make sure the metafield contains data

• Copy the metafield key exactly from Shopify (do not add extra spaces)

• Make sure your metafield type is text. If you want to display other types such as images, links, etc., please contact our support team for assistance.

2. Metafield displays empty or shows no content

Possible causes:

• The product has not been assigned a value for the metafield

• The metafield was created but not applied to the product

How to fix:

• Open the product in Shopify Admin

• Scroll down to the Product metafields section and enter a value for the corresponding metafield

• Save the product and refresh the Ecombe page

FAQ

1. Can I use one product metafield for multiple products?

Yes. Product metafields are created at the definition level, so you can use the same metafield for multiple products and assign different values to each product.

2. Do I need to create a new metafield for each product?

No.You only need to create the metafield once, then assign values to each product in Shopify Admin.

3. Is the metafield key case-sensitive?

Yes. Metafield keys are case-sensitive, so you must enter the exact namespace and key as shown in Shopify Admin.

4. Why does the metafield display correctly in Shopify but not on the Ecombe page?

Possible reasons:

• The Ecombe page has not been published

• The element is not correctly linked to the metafield key

• The product selected in the Featured Product element is different from the product where the metafield value was assigned