Metafield

Metafield content shows customer metafields in Shopify customer accounts, and can let customers fill in or change details like their birthday or preferred size.

Before you start

Create the customer metafield definitions you want to use in your Shopify admin first.

1. In your Shopify admin, go to Settings > Metafields and metaobjects > Customers and create a definition.
2. Set Customer Account API access:
   • Read to show the value only.
   • Read and write to let customers fill it in or change it.

Content that uses a definition customers can’t read (no Customer Account API access) isn’t shown in customer accounts.

Types

Under Add content, choose a type from Customer information that matches the definition’s type.

Type	Definition types	What customers do
Text	Single line text, multi-line text, URL	Enter it with the edit button
Date	Date, date and time	Pick a date with the edit button
Number	Integer, decimal	Enter it with the edit button
Choice	Text with a list of values (and lists of it), metaobject reference	Pick one from a dropdown, or several with checkboxes for a list
On/Off	True or false (boolean)	Switch it with a checkbox or switch
Image	File reference	View only
Image list	List of file references	View only (grid)
Consent check	True or false (to save to)	Review the policy and click Agree and save
Marketing	None (Shopify marketing consent)	Subscribe or unsubscribe from email with a switch

Common settings

• Display label: The name shown above the value (for example, Date of birth).
• Metafield definition: Click Browse and choose the customer metafield definition to show.
• Customer editable: Lets customers change the value. Available when the definition’s Customer Account API access is Read and write. Images can’t be edited yet.
• Edit once only: Allows editing only while the value is empty. Use it for details like birthdays that you don’t want changed once set.
• Copyable: Shows the value in a read-only field so customers can copy it. Available for text, dates, and numbers. It can’t be on at the same time as Customer editable.

If there’s no value yet, ”-” is shown.

Settings by type

Choice

Choices are loaded automatically from the metafield definition (or the metaobject’s entries). If you change the choices in the definition, the change appears without saving the block again. If the definition has no choices, or there are no entries, customers can’t edit it (the value is still shown).

On/Off

• Display format: Checkbox (default) or switch.

Image and image list

• Aspect ratio, Image fit, and Border radius: The same as image content.

Consent check

Collects agreement to your terms of service or other policies.

• Content reference: The policy or store page customers agree to (required).
• Save check state (optional): A true or false (boolean) customer metafield that records the agreement. If you don’t choose one, only the text is shown and no record is kept.

Customers see a Confirmed or Unconfirmed label and a Confirm button. The button opens the policy, and Agree and save records their agreement.

Marketing

• Marketing type: Email marketing (default) or SMS marketing.
• Customer editable: For email marketing, lets customers subscribe or unsubscribe with a switch. For SMS, only Subscribed or Unsubscribed is shown.

Edit together in a group

Put several metafields in a group so customers can edit them together in one dialog. Consent checks and marketing can’t be put in a group.

Shopify Flow

When a customer saves a value, the Metafield submitted trigger runs. When they change consent or their email subscription, the Consent updated trigger runs. For details, see Integrations.