Skip to main content
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.

​
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

1

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

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

Choose the collection type

Select Manual or Automated. For automated collections, add one or more rules (see below).
4

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

Add SEO metadata

Optionally enter a custom seo.title and seo.description for the collection page.

​
Automated collection rules

Each rule has three parts: You can add as many rules as needed. A resource is included in the collection when it matches any of the defined rules.
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 full path (array of ancestor IDs) and level (depth in the tree) automatically.

​
Creating a category

1

Enter a name and slug

The slug is auto-generated from the name. It appears in category URLs and internal references.
2

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

Set display order

Use the Display Order number to control the sort position among siblings. Lower numbers appear first.
4

Set visibility status

  • active — visible to customers browsing the storefront
  • hidden — suppressed from the storefront (useful for staging or internal-use categories)
5

Add an image and description

Both are optional but improve the browsing experience when your storefront theme renders category pages.
6

Add SEO metadata

Set metaTitle and metaDescription per category page individually.
Deleting a parent category does not automatically delete its children. Move or reassign child categories before removing a parent to avoid orphaned entries.

​
Collections vs. categories at a glance

​
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 type collection. Navigation items support dropdown and mega-menu layouts, so you can surface featured collections alongside other links.