Shopify “Taxonomy” object (how you find taxonomy category IDs)

GraphQL Admin API Troubleshooting
1

WE are having issues pushing product data with the proper Taxonomy getting tagged. We continue to see products listed in the wrong categories.

Jeff from Listernaut

2

Hey @Jeff_Kaplan! There are a few ways to find taxonomy category IDs:

  1. Use the taxonomy query in the Admin GraphQL API - you can search categories by keyword. For example, searching “shoes” returns all matching categories with their IDs and full paths.

  2. Browse the Taxonomy Explorer interactively - click through the hierarchy and grab the ID you need.

  3. Download the categories.txt file from the GitHub repo if you need to work with the full list locally.

Once you have the category ID (e.g., aa-5), you set it on products using the category field in productSet with the full GID format: gid://shopify/TaxonomyCategory/aa-5.

Can you share how you’ve been setting the category so far and an example showing what category was assigned and what was expected? Happy to take a closer look!