Customer tax settings now available in Admin API
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on April 24, 2026.
This Shopify update is categorized as API, Update, Admin GraphQL API, 2026-07.
What changed
Starting in API version 2026-07, the taxSettings field on the Customer object will be publicly accessible in the Admin GraphQL API. Apps with the read_customers or read_taxes access scopes can now query a customer's tax ID, such as a VAT number, which is collected and validated during checkout. This update aligns with the CompanyLocation.taxSettings.taxRegistrationId, which has been available since API version 2025-01 for B2B customers. Example query: { customer(id: "gid://shopify/Customer/customer_id") { taxSettings { taxId } } } This is a read-only change. The taxId field returns the tax ID as a string or null if the customer hasn't provided one.
Who is affected
Developers building or maintaining Shopify checkout customizations should review this change.
What action may be needed
Review whether the new capability is relevant to your app. If you plan to use it, test the affected API or workflow before adopting it in production.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →