> For the complete documentation index, see [llms.txt](https://help.ecombe.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.ecombe.com/editor-and-functions/editor-features/how-to-set-up-product-metafields.md).
# 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 Metafield**s and move directly to [**Connect the Product Metafield to Ecombe Featured Product**.](#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**](#connect-the-product-metafield-to-ecombe-featured-product-1)
### 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.
{% stepper %}
{% step %}
#### Access Product Metafield Definitions
Go to **Shopify Settings → Metafields and metaobjects → Products**
{% endstep %}
{% step %}
#### 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.
{% endstep %}
{% step %}
#### 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**.
{% endstep %}
{% step %}
#### 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.
{% endstep %}
{% endstepper %}
## 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
