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-1CBD Capsules & Softgelshb-1-9-6-10-2CBD Oils & Tinctureshb-1-9-6-10-3-1CBD Gummiesfb-4-5-4-1Prefilled 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")returnsnulltaxonomy { categories(first: 50, childrenOf: "gid://shopify/TaxonomyCategory/hb-1-9-6-10") }returns[]taxonomy { categories(first: 20, search: "CBD Gummies") }returns no resultsVaping Devices(fb-4-5-4) is alsoisLeaf: truewith 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
- Is there a rollout timeline for the v2026-10 categories to reach the Admin API and the Shopify admin?
- 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?
- Will the new attribute values from 2026-10 (e.g. new
shopify.flavorvalues such as “Mixed berry”) become available at the same time as the categories?
Thanks!