Skip to main content
Anchor to Taxonomy

Taxonomy

object

Represents Shopify's standardized product taxonomy tree. Provides categories that you can filter by search criteria or hierarchical relationships.

You can search categories globally, retrieve children of a specific category, find siblings, or get descendants. When you specify no filter arguments, you get all top-level categories in the taxonomy.

Anchor to FieldsFields

Anchor to categoriescategories
•TaxonomyCategoryConnection!
non-null

Returns the categories of the product taxonomy based on the arguments provided. If a search argument is provided, then all categories that match the search query globally are returned. If a children_of argument is provided, then all children of the specified category are returned. If a siblings_of argument is provided, then all siblings of the specified category are returned. If a decendents_of argument is provided, then all descendents of the specified category are returned. If no arguments are provided, then all the top-level categories of the taxonomy are returned.

Arguments

Anchor to searchsearch
•String

Searches the product taxonomy for matching categories.

Anchor to childrenOfchildrenOf
•ID

The ID of the category associated with the child categories to return.

Anchor to siblingsOfsiblingsOf
•ID

The ID of the category associated with the sibling categories to return.

Anchor to descendantsOfdescendantsOf
•ID

The ID of the category associated with the descendant categories to return.

Anchor to firstfirst
•Int

The first n elements from the paginated list.

Anchor to afterafter
•String

The elements that come after the specified cursor.

Anchor to lastlast
•Int

The last n elements from the paginated list.

Anchor to beforebefore
•String

The elements that come before the specified cursor.

Was this section helpful?

Anchor to QueriesQueries

Anchor to taxonomytaxonomy
•query

Access to Shopify's standardized product taxonomy for categorizing products. The Taxonomy organizes products into a hierarchical tree structure with categories, attributes, and values.

Query categories using search terms, or navigate the hierarchy by requesting children, siblings, or descendants of specific categories. Each TaxonomyCategory includes its position in the tree, parent-child relationships, and associated attributes for that product category.

Was this section helpful?