For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dev Portal
DocsAPI ReferenceLearnCommunityChangelog
DocsAPI ReferenceLearnCommunityChangelog
    • About Our APIs
  • REST
    • Overview
      • Overview
        • Brands
        • Categories
            • GETList Categories
            • POSTCreate Category
            • DELDelete Categories
            • GETGet Category
            • PUTUpdate Category
            • DELDelete Category
        • Category Trees
        • Products
        • Product Modifiers
        • Product Variants
        • Product Variant Options
      • Payments
  • GraphQL
    • Overview
  • MCP
    • Overview
Dev Portal
LogoLogo
On this page
  • Resources
  • Webhooks
  • Additional Catalog endpoints
RESTAdminCatalog

Catalog - Categories

Was this page helpful?
Previous

Delete Brand Metafield

Next

List Categories

Built with

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

Warning:

  • 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.

Resources

Webhooks

Learn more about Category webhook events.

Additional Catalog endpoints

  • Brands
  • Category trees
  • Products
  • Product modifiers
  • Product variants
  • Product variant options