Categories
Organize your products into categories for navigation and discoverability in your Storefront app.
Categories
Categories organize products into logical groups for customer navigation. A category can represent a menu section ("Appetizers", "Mains", "Desserts"), a product type ("Electronics", "Clothing"), or any grouping that makes sense for your store.
Navigate to Storefront → Products and use the category sidebar to manage categories.
Creating a Category
Navigate to Storefront → Products.
In the category sidebar, click New Category (or the + icon).
Enter the Name and an optional Description.
Upload an optional Image — used as a thumbnail in your app's navigation menu.
Click Save.
Assigning Products to Categories
Each product has a primary category_uuid — its main category — selected from the Category dropdown when creating or editing the product.
In addition to the primary category, products can also belong to many Catalog Categories through the catalog_category_product pivot. This is what powers the per-catalog navigation: a single product (e.g. Cheeseburger) can appear in Lunch Specials in your weekday catalog and Family Favourites in your weekend catalog without duplication.
Example: Cheeseburger → primary category Burgers, also assigned to catalog categories Lunch Specials (weekday catalog) and Family Favourites (weekend catalog).
Nested Categories (Subcategories)
Storefront supports hierarchical categories. When creating a category, set a Parent Category to make it a subcategory.
Example structure:
Clothing
├── Men's
│ ├── T-Shirts
│ └── Trousers
└── Women's
├── Dresses
└── TopsYour frontend app can use the parent/child relationship to build a multi-level navigation menu.
Categories in Catalogs
Categories also play a role in Catalogs — named collections of categories and products used for things like food truck menus or seasonal specials. See Food Trucks for how catalogs are assigned to mobile stores.
Category API
Fetch all categories for a store using the public API. Pass your store key as a bearer token:
GET /storefront/v1/categories
Authorization: Bearer store_your_store_keyEach category's response includes its id, name, description, image_url, and any nested children. Categories created via a Store are scoped for: storefront_product; networks have a separate set of categories scoped for: storefront_network used to tag stores within the network.