What arguments does categoryList accept?

The categoryList query accepts 3 arguments: filters (CategoryFilterInput); pageSize (Int); currentPage (Int).

What does categoryList return?

categoryList returns [CategoryTree].

Does categoryList require authentication?

categoryList can be called anonymously — no Authorization header required.

Is categoryList still supported?

categoryList is deprecated. Use `categories` instead.

MageSmith

QueryCatalog · Magento 2.4.9 Deprecated

categoryList

Q: What does the categoryList query do in Magento 2 GraphQL?

categoryList is a Magento 2 GraphQL query in the Catalog module. Return an array of categories based on the specified filters. It returns [CategoryTree] and is callable anonymously.

categoryList is a Magento 2 GraphQL query in the Catalog module. Return an array of categories based on the specified filters. It returns [CategoryTree] and is callable anonymously.

Deprecated: Use `categories` instead.

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

[CategoryTree]

Resolver class

Magento\CatalogGraphQl\Model\Resolver\CategoryList

Cache

identity: Magento\CatalogGraphQl\Model\Resolver\Category\CategoriesIdentity

Arguments

filters CategoryFilterInput

Identifies which Category filter inputs to search for and return.

pageSize Int default: 20

Specifies the maximum number of results to return at once. The default value is 20.

currentPage Int default: 1

Specifies which page of results to return. The default value is 1.

Example request

Auto-generated from the SDL — paste-ready against your store's /graphql endpoint. Replace the host, store code, and any required values before running.

Headers

Content-Type

application/json

Store

default store view code; use 'default' for the single-store baseline

Query

query {
  categoryList {
    children { ... }
  }
}

Variables

{}

Related in CatalogGraphQl

Other fields shipped by the same module.

Query

Every Magento dev tool, in one hosted workspace.

Free to sign up. Nothing to install. Drafts, audits, and projects saved across every tool.

Open app →