# 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.&#x20;

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.&#x20;

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2F2ymSig8DqQ6eAdgjr7iP%2F2025-11-28_10-37-44.png?alt=media&#x26;token=fd252878-63a5-48b1-9704-1a92eb405750" 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="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FyBRF3GaaIntMYOmk2ZzT%2F2026-01-29_17-13-49.png?alt=media&#x26;token=49d262ec-47dc-4722-850e-8d11274ec59c" 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="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2F5Bs8yeG77mKnFVrw7yci%2Fimage.png?alt=media&#x26;token=25c7f032-6bbe-41af-accb-5b406fd05fb4" 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="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FgkIVBfhyC6vhp3JeDeV1%2Fimage.png?alt=media&#x26;token=650148fc-80fa-4b88-a17e-17cbc2658c42" 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="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FeXMLPxz5zzJYfkgtYFbz%2F2025-11-28_10-57-36.png?alt=media&#x26;token=27093b22-0302-4a78-ab7e-4883feb109f7" 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="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FfBqsdvASjaJVQlCcNNXJ%2F2025-11-28_10-55-20.png?alt=media&#x26;token=57abfdef-1e1c-464f-83ee-d6b0cf600548" alt=""><figcaption></figcaption></figure>

***

#### Need More Help?

If you still need assistance, please contact us at [**support@powerfulform.com**](mailto:support@powerfulform.com). Our team will be happy to help you resolve any issues or guide you further&#x20;
