Retrieving Customer Tags by Email at Checkout - Query Issue

Topic summary

Issue: A custom Checkout UI extension needs to read customer tags when a shopper enters an email at checkout, including cases where the shopper isn’t logged in but has an active Shopify account.

Problem details:

  • GraphQL query to fetch customer tags by email fails in the checkout extension with: “Field ‘customers’ doesn’t exist on type ‘QueryRoot’.”
  • The same query succeeds in the GraphiQL app, and all requested permissions were granted.

Root cause and scope:

  • Checkout UI extensions currently cannot access customer tags (and the ‘customers’ GraphQL field). This API capability is not available in the checkout extension context, which explains the discrepancy with GraphiQL.

Current status:

  • Marked as a feature improvement and flagged to the checkout team.
  • No workaround or alternative method was provided to query customer tags by email within the checkout extension.

Notes:

  • Screenshots appear to show the error and permission settings but are not essential beyond confirming the failure context.

Resolution: Open/ongoing; awaiting potential platform update.

Summarized with AI on December 23. AI used: gpt-5.

Hi everyone,

We’re using our own checkout extension and want to implement a feature that depends on customer tags. Specifically, we need to retrieve customer tags when a customer enters their email at checkout. Despite having all the necessary permissions granted by the store owner, our query to get the customer tags isn’t working. The request fails with the error: “Field ‘customers’ doesn’t exist on type ‘QueryRoot’”.

Interestingly, the same query works perfectly fine when run in the GraphiQL app. Our challenge is that the customer might not be logged in, but they still have an active account in Shopify. In this scenario, we need to query the customer by the entered email to check if they have specific tags.

Has anyone faced a similar issue or can suggest a way to achieve this? Any help would be greatly appreciated.

Thank you!

Hi Muratx10,

Checkout UI extensions can’t currently access customer tags, which is why the query is working on the GraphiQL tool but not within a checkout UI extension. I’ve flagged this as a feature improvement with our checkout team.