Skip to main content

Deprecation of the ProductVariant.taxCode field

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:

  1. Audit Your Current Implementation: Identify where your app reads or writes the taxCode field.
  2. Update Your GraphQL Queries: Remove references to the taxCode field from your queries and mutations.
  3. 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.

Was this section helpful?