Tags:
- Action Required
- Admin GraphQL API
- Admin REST API
- 2025-10
Deprecation of the ProductVariant.taxCode field
ProductVariant.taxCode fieldAs of Admin GraphQL API version 2025-10, we are deprecating the  field from the  object. This change is part of the Avalara AvaTax app deprecation and will affect how you handle tax classification for product variants.
The  field on  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  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  field, you should:
- Audit Your Current Implementation: Identify where your app reads or writes the field.
- Update Your GraphQL Queries: Remove references to the field from your queries and mutations.
- Test Thoroughly: Ensure your app continues to function correctly without the deprecated field.
Timeline
The  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.