Skip the manual navigation

Add metafields to variants and customers

Define custom fields for variants and customers, fill in their values, and decide whether the storefront may read them.

16 min read · Updated October 3, 2026 · Screenshots use demonstration accounts

On this page
  1. 1. Open the metafield definitions
  2. 2. Add a definition
  3. 3. Choose Storefront access
  4. 4. Pin a definition (optional)
  5. 5. Fill in a variant's values
  6. 6. Fill in a customer's values
  7. 7. Know where values show
  8. 8. Privacy and exports
  9. Completion checklist
  10. Troubleshooting
Before you start

You need to be able to edit products (for variants) or customers. Decide first which fields you need, for example a "Material" for variants or an internal "VIP note" for customers, and whether each may ever be shown on your storefront.

On a phone? Open the admin menu to find the same section. Screenshots below show the desktop view; tap “Open full size” for a closer look.
STEP 1

Open the metafield definitions

Open any variant page (Products > a product > a variant) or any customer page and find the Metafields card. Select Add definition (or Manage definitions if some already exist). This opens the Metafields page, which has four tabs: Products, Collections, Variants and Customers.

STEP 2

Add a definition

On the tab for the kind of record, select Add definition and fill in the form, then select Add definition again to save.

  • Name: what you see in the editor, for example Material.
  • Namespace and Key: the stable address of the field, for example custom and material (shown on the card as custom.material). Choose them carefully; themes and apps may rely on them.
  • Type: Single line text, Multi-line text, Rich text, Integer, Decimal, True or false, JSON, Color, URL, Date, File, Product reference or Product list.
  • Description (optional), and for some types Minimum, Maximum or Maximum length.
STEP 3

Choose Storefront access

Private — admin only is the default and keeps the value inside your admin. Visible — themes and apps can read this value makes it available to the storefront; choose it only for values you are happy for anyone to see in the page source.

STEP 4

Pin a definition (optional)

Tick Pin this definition to the top of the editor to show it first. Unpinned definitions sit behind a Show all (n) toggle on the Metafields card. You can also tick Translate this field into Sinhala and Tamil to store a separate value per language.

STEP 5

Fill in a variant's values

Go to Products, open the product, and select the variant. In the Metafields card, enter a value for each field and save with the save bar at the top. Clearing a field and saving removes the value, and a value that does not fit the field's type (for example text in an Integer field) is not saved.

STEP 6

Fill in a customer's values

Open the customer, complete the Metafields card and save the customer. Customer metafields are saved together with the rest of the profile, so you need permission to edit customers.

STEP 7

Know where values show

Private fields appear only in your admin. A Visible variant field is included in that product's data for the storefront, per variant, so a theme or app can read it. A Visible customer field is only ever available to that customer when they are signed in to their own account; it is never listed publicly. Saving a value does not add anything to your theme by itself, so a theme section or app has to display it.

STEP 8

Privacy and exports

Erasing a customer's personal data clears their metafields with the rest of the profile, and a customer data export includes them. The products CSV export, import and backup carry a variant metafields column (JSON, on variant rows; leave it blank to keep existing values).

CHECK YOUR WORK

You’re ready when…

  • The definition exists on the right tab (Variants or Customers).
  • Storefront access is Private unless you want the storefront to read it.
  • You saved the variant or customer after typing values.
  • A theme section or app is set up to show any Visible field.

IF SOMETHING DOESN’T LOOK RIGHT

Troubleshooting

I cannot see the Metafields card on the variant page.

The card appears on variant and customer pages even before you have any definitions; use Add definition to create the first one. If the page itself does not open, check that your role can edit products or customers.

My value disappeared after saving.

A value that does not match the definition's type (a non-whole number in an Integer field, an invalid date or URL) is dropped rather than stored. Re-enter it in the correct format.

A Visible customer field does not show on my storefront.

Customer values are only returned to the signed-in customer in their own account data, and no theme block renders them automatically.

Can I edit metafields in the bulk editor?

No. The bulk editor covers title, status, vendor, type, tags, price, cost, SKU and similar fields, but not metafields. Edit them on each variant or customer, or use the products CSV for variant metafields.

In this section: Products

Still need help?

Tell us your store address and what you’re trying to do. Leave out passwords and payment details.

Contact support