Taxonomy 2026-10 categories (e.g. hb-1-9-6-10-3-1) not available in Admin API: when will they roll out?

Hi! The product-taxonomy v2026-10 release (published Oct 27, PR #1031) adds new subcategories, for example under Vitamins & Supplements > CBD Supplements:

  • hb-1-9-6-10-1 CBD Capsules & Softgels
  • hb-1-9-6-10-2 CBD Oils & Tinctures
  • hb-1-9-6-10-3-1 CBD Gummies
  • fb-4-5-4-1 Prefilled Cannabis Vaporizers

None of them are available in the Admin GraphQL API yet, on any version I tried (2026-01, 2026-07, 2026-10, unstable).

1. Setting the category fails

mutation ProductUpdate($product: ProductUpdateInput!) {
  productUpdate(product: $product) {
    product { id }
    userErrors { field message }
  }
}

Variables:

{
  "product": {
    "id": "gid://shopify/Product/<id>",
    "category": "gid://shopify/TaxonomyCategory/hb-1-9-6-10-2"
  }
}

Response: userErrors: [{ "message": "Invalid product_taxonomy_node_id" }]

The same mutation with the parent gid://shopify/TaxonomyCategory/hb-1-9-6-10 (CBD Supplements) works.

2. The live taxonomy doesn’t have them

query {
  node(id: "gid://shopify/TaxonomyCategory/hb-1-9-6-10") {
    ... on TaxonomyCategory { name level isLeaf childrenIds }
  }
}

Response:

{ "name": "CBD Supplements", "level": 5, "isLeaf": true, "childrenIds": [] }

Also:

  • node(id: "gid://shopify/TaxonomyCategory/hb-1-9-6-10-3-1") returns null
  • taxonomy { categories(first: 50, childrenOf: "gid://shopify/TaxonomyCategory/hb-1-9-6-10") } returns []
  • taxonomy { categories(first: 20, search: "CBD Gummies") } returns no results
  • Vaping Devices (fb-4-5-4) is also isLeaf: true with no children

The same queries work for existing data (e.g. childrenOf: hb-1-9-6 returns its 12 children), all responses are HTTP 200 with no access errors, and the app has write_products.

Questions

  1. Is there a rollout timeline for the v2026-10 categories to reach the Admin API and the Shopify admin?
  2. Is there a way to tell which taxonomy release a store / API currently serves, so apps don’t write category IDs that aren’t live yet?
  3. Will the new attribute values from 2026-10 (e.g. new shopify.flavor values such as “Mixed berry”) become available at the same time as the categories?

Thanks!

Hi @leticia,

I checked the rollout, and v2026-10 is published in the taxonomy repository but still waiting to roll out generally to Shopify admin and the Admin API. I don’t have a confirmed date to share yet.

There isn’t currently a public field that reports a store’s taxonomy release. The node(id:) checks you’re already doing are the right way to verify whether a category is available. Changing Admin API versions won’t select a different taxonomy release.

The new taxonomy values, including Flavor’s “Mixed berry,” are included in the same rollout as the categories.