Actions83
- Product Actions
- Product Variant Actions
- Collection Actions
- Article Actions
- Blog Actions
- Customer Actions
- Order Actions
- Draft Order Actions
- Inventory Actions
- File Actions
- Publication Actions
- Translation Actions
- Taxonomy Actions
- Metaobject Actions
- Metaobject Definition Actions
- Metafield Value Actions
- Metafield Definition Actions
- Service Actions
Taxonomy → Search Categories
AI-generatedSummary
Searches Shopify's product taxonomy categories by text query via the Admin GraphQL API and returns matching categories, with optional hierarchy fields, pagination, and selectable output shape.
Inputs
- authentication — Credential type: Admin API Credentials (access token or Dev Dashboard client credentials, default) or OAuth2.
- search (required) — Text to search in Shopify product taxonomy categories.
- returnFields — Extra field groups to include: Ancestor IDs, Children IDs, Parent ID (all selected by default). Core identity fields are always returned.
- getAll — If true, fetches all pages of results. Default false.
- limit — Max results to return when Get All is off (1–250, default 50).
- taxonomyOptions — Options collection. Cursor (afterCursor) continues from a specific pagination cursor.
- outputMode — Simplified (default), Raw (full Shopify response), or Selected Fields.
- selectedFields — Comma-separated field names to keep in output; shown only when Output Mode is Selected Fields.
Output shape
A list of taxonomy category items matching the search query, one n8n item per category in Simplified mode.
The exact fields depend on Output Mode and Fields to Return. Raw returns the unmodified Shopify response. Selected Fields trims each item to the listed fields. The source pack shows only signatures for the registry and taxonomy GraphQL template, so the exact query and simplified field names are not visible.
Examples
Example 1: Find a category ID for 'sneakers' to assign to a product.
Search Query = sneakers, Get All off, Limit = 10, Output Mode = Simplified.
Example 2: Export every category matching 'clothing' with its hierarchy.
Search Query = clothing, Get All on, Fields to Return = Ancestor IDs, Children IDs, Parent ID.
Example 3: Get only IDs and names for a lookup table.
Output Mode = Selected Fields, Selected Fields = id,name.