---
title: Deprecation of the ProductVariant.taxCode field - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/deprecation-of-tax-code-field'
  md: 'https://shopify.dev/changelog/deprecation-of-tax-code-field.md'
metadata:
  effectiveApiVersion: 2025-10
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
    - displayName: Admin REST API
      handle: admin-rest
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation Announcement
    handle: deprecation
  indicatesActionRequired: true
  createdAt: '2025-07-25T15:16:17-04:00'
  postedAt: '2025-07-30T14:46:00-04:00'
  updatedAt: '2025-07-30T14:46:43-04:00'
  effectiveAt: '2025-07-31T12:00:00-04:00'
---

July 30, 2025

Tags:

* Action Required
* Admin GraphQL API
* Admin REST API
* 2025-10

# 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](https://help.shopify.com/en/manual/taxes/tax-services#migrating-from-avatax).

For guidance on using the new Avalara Tax Compliance app, refer to the documentation on [mapping Avalara tax codes in Shopify](https://knowledge.avalara.com/bundle/uqa1710993217954_uqa1710993217954/page/dir1743588192947.html).