Catalog API

Catalog - Categories

The Catalog API manages products, categories, brands, bulk pricing rules, and more. To learn more about catalog resources, see the Catalog overview.


  • The Catalog V3 categories endpoints were primarily useful in applications for single storefront stores and are deprecated. We still support these endpoints, but will not implement new features within them. The endpoints will continue working as is.
  • To manage categories, use the Catalog V3 category trees endpoints. These endpoints work for both MSF-enabled stores and single storefront stores, and are backwards-compatible with categories created using Catalog V3 categories.

Category images have their own dedicated create a category image and delete a category image endpoints.

In addition, categories have metafields that you can use to store information structured in key-value pairs; learn more about creating category metafields, updating category metafields, and deleting category metafields.

This API family also contains endpoints to update product sort order within a category.

To learn more about authenticating Catalog endpoints, locate the Authentication section at the top of each endpoint, then click Show Details.



Learn more about Category webhook events.

Additional Catalog endpoints

Did you find what you were looking for?