Skip to main content

Customer Metafields & New Customer Accounts (NCA)

How to enable Customer Account API access for customer metafields when using Shopify's New Customer Accounts, so custom blocks in your Tapcart app can read membership, loyalty, and other customer data.

If you're using Shopify's New Customer Accounts (NCA) and have custom blocks in your Tapcart app that depend on customer metafields (like membership tiers, loyalty status, or club pricing), there's an additional configuration step required in Shopify to make those metafields accessible.

Why This Matters

Tapcart's existing metafields setup guide walks through enabling Storefront API access for product, collection, and order metafields. However, customer metafields work differently. They're tied to the authenticated customer session and require a separate access setting to expose them to the app.

When NCA is enabled, Tapcart uses Shopify's Customer Account API to fetch the logged-in customer's data. If your customer metafields don't have Customer Account API access enabled, that data won't pull through and any custom blocks relying on it (membership checks, gated content, personalized pricing, etc.) will not work as expected.

How to Enable Customer Account API Access for Customer Metafields

  1. In your Shopify Admin, go to Settings and select Metafields and metaobjects

  2. Choose Customers

  3. Select the metafield definition you want to use in app

  4. Scroll down to the Access section

  5. Under Customer Account API access, select Read

  6. Save the metafield definition

  7. Repeat for any other customer metafields used in your app

Note: Read access is sufficient for Tapcart to fetch and use the metafield value in custom blocks. Write access is not required.

Common Symptom

If logged-in customers aren't being recognized by a custom block and you've recently enabled NCA, missing Customer Account API access on your customer metafields is the most likely cause.

Need Help?

If you have additional questions, reach out through LiveChat in your Tapcart dashboard or email [email protected].

Did this answer your question?