Shopify
Customer Metafields
Write form submission values directly into Shopify customer metafields on submission. Available on Basic and higher plans.
Last updated June 15, 2026
Customer Metafield Mapping writes form values directly into Shopify customer metafields when the form is submitted. Use it to store custom customer data preferences, loyalty tier, birthday, size, or any other attribute in your Shopify customer records.
Available on Basic and higher plans.
Prerequisites
Before mapping in the app, create the metafield definitions in Shopify:
- Go to Shopify Admin → Settings → Custom data → Customers.
- Click Add definition.
- Set the Namespace, Key, and Type for each metafield you want to populate.
How to set up
Enable customer metafields
In the form builder → Settings → Shopify → Customer Tags → Enable Customer Metafields.
Add a mapping
Click Add Mapping. Select the metafield (namespace + key) and the form field whose value should write to it.
Repeat for each field
Add one mapping entry per metafield you want to populate.
Save
Click Save.
On submission, the app calls Shopify's metafieldsSet mutation this creates the metafield if it doesn't exist, or updates it if it does.
Compatible field types
Each Shopify metafield type must be matched to a compatible form field type:
| Shopify Metafield Type | Compatible Form Field |
|---|---|
single_line_text_field | Text, Telephone |
multi_line_text_field | Textarea |
boolean | Single Checkbox |
number_integer | Number |
number_decimal | Number |
date | Date |
date_time | Date & Time |
url | URL |
Type matching
Mapping a form field to an incompatible metafield type will cause the metafield write to fail silently. Always match the Shopify metafield type to the correct form field type using the table above.
Phone number format
Telephone fields store the full E.164 international format (e.g. +919876543210) both in the form submission and in the single_line_text_field metafield. This matches the format Shopify uses for phone numbers.
Viewing metafield values
After a form submission, go to Shopify Admin → Customers → [the customer] → Metafields to confirm the values were written correctly.
Metafields are upserted per submission if the customer submits the form again, their metafield values are updated with the new submission data.
Was this page helpful?