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.