As of Admin GraphQL API version 2025-10, we are deprecating the taxCode field from the ProductVariant object. This change is part of the Avalara AvaTax app deprecation and will affect how you handle tax classification for product variants.
The taxCode field on ProductVariant objects will not be available in future API versions. If your app currently relies on this field for tax calculations or reporting, you must update your implementation before the field is fully removed.
Why We're Making This Change
We are deprecating the taxCode field because the Avalara AvaTax app, which powered this functionality, is being discontinued. This field applies only to the stores that have the Avalara AvaTax app installed.
What You Need to Do
If your app uses the taxCode field, you should:
-
Audit Your Current Implementation: Identify where your app reads or writes the
taxCodefield. -
Update Your GraphQL Queries: Remove references to the
taxCodefield from your queries and mutations. - Test Thoroughly: Ensure your app continues to function correctly without the deprecated field.
Timeline
The taxCode field will continue to return data through API version 2025-10. However, you should migrate away from it as soon as possible, as future API versions will not include this field.
Learn More
For more information on the deprecation of the Avalara AvaTax app, refer to the documentation on migrating from AvaTax.
For guidance on using the new Avalara Tax Compliance app, refer to the documentation on mapping Avalara tax codes in Shopify.