Cartble gives you two complementary tools for organizing your catalog: collections and categories. They serve different purposes and live in different parts of the admin. Collections are customer-facing groupings used to curate themed pages on your storefront (for example, “Summer Picks” or “Staff Favorites”). Categories form an internal taxonomy that classifies products for filtering and SEO — they are hierarchical and can be nested arbitrarily deep.Documentation Index
Fetch the complete documentation index at: https://docs.cartble.com/llms.txt
Use this file to discover all available pages before exploring further.
Collections
Navigate to Admin → Collections to manage your collections.Collection types
Manual
You hand-pick which resources belong to the collection. Use this for editorial or curated groups where you control membership directly.
Automated
Cartble populates the collection automatically based on rules you define. Any resource that matches the conditions is included without further action.
Creating a collection
Set the name and slug
Enter a name (e.g., “Best of 2025”). The slug is auto-generated from the name and is used in the storefront URL (
/collections/best-of-2025). You can edit the slug manually before saving.Add a description and cover image
The description appears on the collection page in your storefront. Upload a cover image to give the collection a visual identity.
Choose the collection type
Select Manual or Automated. For automated collections, add one or more rules (see below).
Configure display options
- Featured — marks the collection as highlighted; themes can use this flag to call out the collection in hero sections or promotional areas.
- Show in menu — makes this collection available as a navigation target when you build menus in Admin → Navigation.
Automated collection rules
Each rule has three parts:| Field | Options |
|---|---|
| Attribute | Item Title, Price, Promotional Price, Tag, Category, Stock |
| Relation | equals, does not equal, contains, does not contain, greater than, less than, starts with, ends with |
| Value | The string or number to match against |
Automated collections update in real time as resources are created or edited. You do not need to manually add products after a rule is configured.
Categories
Navigate to Admin → Categories to manage your category hierarchy. Categories are organized in a tree structure. Each category can have a parent, and Cartble tracks the fullpath (array of ancestor IDs) and level (depth in the tree) automatically.
Creating a category
Enter a name and slug
The slug is auto-generated from the name. It appears in category URLs and internal references.
Select a parent (optional)
Leave the parent blank to create a root-level category. Selecting a parent nests the new category underneath it. Cartble prevents circular nesting automatically.
Set display order
Use the Display Order number to control the sort position among siblings. Lower numbers appear first.
Set visibility status
active— visible to customers browsing the storefronthidden— suppressed from the storefront (useful for staging or internal-use categories)
Add an image and description
Both are optional but improve the browsing experience when your storefront theme renders category pages.
Collections vs. categories at a glance
| Collections | Categories | |
|---|---|---|
| Purpose | Storefront curation | Internal taxonomy |
| Structure | Flat | Hierarchical (tree) |
| Membership | Manual or rule-based | Assigned per resource |
| Navigation menus | Yes (showInMenu) | Yes (via NavigationItem type category) |
| SEO fields | seo.title, seo.description | metaTitle, metaDescription |
Using collections in navigation
When you toggle Show in menu on a collection, it becomes available in the Navigation Editor (Admin → Navigation) as a link target of typecollection. Navigation items support dropdown and mega-menu layouts, so you can surface featured collections alongside other links.