Preparing for the Deprecation of ProductVariant.taxCode Field

Preparing for the Deprecation of ProductVariant.taxCode Field

Shopify Updates: 

Overview of the Deprecation

Starting with Admin GraphQL API version 2025-10, Shopify is deprecating the taxCode field from the ProductVariant object. This update coincides with the discontinuation of the Avalara AvaTax app and impacts how you classify taxes for product variants.

Why Is This Change Happening?

The taxCode field is being retired due to the Avalara AvaTax app's deprecation. This functionality was relevant only for stores using the Avalara AvaTax app. With its removal, Shopify aims to streamline tax compliance processes and encourage migration to the Avalara Tax Compliance app.

Impacted Users

If your app currently relies on the taxCode field for tax calculations or reporting, adjustments will be required to ensure continued functionality.

Action Items for Developers

To prepare for this change, follow these steps:

  • Audit Your Implementation: Review your app's existing code to identify areas where the taxCode field is used.
  • Update GraphQL Queries: Remove references to the taxCode field from all queries and mutations.
  • Test Thoroughly: Validate your app's functionality to ensure it operates correctly without the deprecated field.

Timeline for Migration

The taxCode field will continue providing data until API version 2025-10, after which it will no longer be available. To avoid potential disruptions, plan your migration as soon as possible.

Additional Resources

By taking timely action, you can ensure your app remains compliant and fully functional.

Back to blog