Skip to main content

ProductCategorySearchInput

Search criteria for product-associated categories.

Provides filtering and search options for categories associated with a specific product. Inherits all CategorySearchInput functionality except categoryId filtering, since the product's categories are already determined.

input ProductCategorySearchInput {
  name: String
  language: String
  slug: [String!]
  parentCategoryId: [Int!]
  hidden: YesNo
  page: Int
  offset: Int
  sortField: CategorySortableFields
  sortOrder: SortOrder!
}

Fields​

ProductCategorySearchInput.name ● String scalar​

Search categories by name.

Performs full text matching against category names in the specified or default language. Case-sensitive search that matches the entire category name.

ProductCategorySearchInput.language ● String scalar​

Language code for localized search.

The language to use when searching categories by name or slug. When omitted, the category's default language is used. Must be a valid ISO 639-1 language code (2 characters).

ProductCategorySearchInput.slug ● [String!] list scalar​

Search categories by URL slugs.

Find categories by one or more SEO-friendly URL slugs. Matches exact slug values in the specified or default language.

ProductCategorySearchInput.parentCategoryId ● [Int!] list scalar​

Filter categories by parent relationships.

Find categories that belong to one or more parent categories. Useful for retrieving subcategories of specific parent categories.

ProductCategorySearchInput.hidden ● YesNo enum​

Filter categories by visibility status.

Find categories by their hidden status. Y = hidden categories, N = visible categories. When omitted, returns both hidden and visible categories.

ProductCategorySearchInput.page ● Int scalar​

Page number for pagination.

The page number to return in paginated results. Must be a positive integer. Defaults to 1.

ProductCategorySearchInput.offset ● Int scalar​

Number of categories per page.

The amount of categories to return per page. Must be a positive integer. Defaults to 12.

ProductCategorySearchInput.sortField ● CategorySortableFields enum​

Field to sort categories by.

Available sortable fields: [name, dateCreated, entityDateChanged]. When omitted, results are returned in default order.

ProductCategorySearchInput.sortOrder ● SortOrder! non-null enum​

Sort order for results.

Determines the sorting direction for the specified sort field. ASC = ascending order, DESC = descending order. Defaults to ascending order.