> For the complete documentation index, see [llms.txt](https://docs.powerfulform.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.powerfulform.com/customer-fields/customer-metafield.md).

# Customer metafield

**What You'll Need**

* A published form in the **Powerful Form Builder** app.
* A **Shopify customer metafield** already created.\
  (*You can create one via Shopify Admin → Settings → Custom data → Customers → Add definition.*)

***

### 📝 Step 1: Create and Use Customer Metafields

1\. From Shopify admin page > go to store **Settings** > click **Metafields and metaobjects**

2\. Click **Customers** > add a  customers metafield or use an existing one. 

For example: the key is **custom.gender** > copy the **Namespace and Key**

Click **Add definition** (or similar) to define a new custom field. You’ll need to specify:

* A **name** (e.g. “Birthday”, “Preferred Language”, “VIP Tier”, etc.)
* A **namespace & key** (internal identifiers for Shopify)
* A **content type** (text, number, date, boolean, etc.) — choose based on the data you want to store.
* (Optional) Description — helps clarify what this metafield is used for

3. Save it. 

<figure><img src="/files/jmsCNu5WsZnaFcAtQeuD" alt=""><figcaption></figcaption></figure>

***

### 📝 Step 2: Connect Your Form Field to the Metafield

1. Go to Powerful Contact Form Builder app > click **Forms** > open a form you want to edit
2. Click **Settings** >  enable **Shopify** and click on **Shopify** option

<figure><img src="/files/XbauawhdXTp6OXo6KLh8" alt=""><figcaption></figcaption></figure>

3. Map form field with metafield.Select the shopify attributes (on the right) to map with form fields (on the left). For example the **Last** **name** field of the form should be mapped with Shopify **last name** attribute.&#x20;

⚠️ **Note**: **Email** field on the form is required to be mapped with **email** attribute of Shopify.

<figure><img src="/files/d1y2I66ouzPUMkYdgJT2" alt=""><figcaption></figcaption></figure>

4. Tick on checkbox **Set metafields for created customer** > map form field with metafields.&#x20;

Click **add mapping metafield row** to add more

You’ll see two dropdown lists:

* Left side = your **Form fields**
* Right side = your **Shopify metafield definitions**

<figure><img src="/files/bTgJsD0F3cXRtKRF1Ssr" alt=""><figcaption></figcaption></figure>

Example mapping:&#x20;

| Form Field | Shopify Metafield |
| ---------- | ----------------- |
| Gender     | custom.gender     |
| Hobby      | custom.hobby      |
| Number     | custom.number     |

5. Click **Save** to apply your metafield mappings.

***

### ✅ How It Works

When a customer fills out the form and submits it: The data from the field you linked will be automatically saved to their **Shopify customer metafield**.

#### Example Scenario

Your form includes a **Gender** field:

* Male
* Female
* Others

<figure><img src="/files/oIkLQEQtetakhBC997MV" alt=""><figcaption></figcaption></figure>

You mapped this field to a Shopify metafield:\
**Namespace.key = custom.gender**

A customer fills in the form and selects:

> **Gender: Male**

Then they submit the form.

The app will:

1. Create or update the Shopify customer profile
2. Save the customer’s answer directly into the metafield you set up

So inside Shopify → Customers → (This Customer):\
You will now see:

**Gender = Male**

<figure><img src="/files/P1UjCLbmf5bJqfwVyIbt" alt=""><figcaption></figcaption></figure>

***

#### Need More Help?

If you still need assistance, please contact us at <contact@globo.io>. Our team will be happy to help you resolve any issues or guide you further&#x20;