Managing categories
The category manager lets you build and maintain your product category tree. You can create root categories, nest subcategories, and edit category details — all from a visual tree interface.
The category list
Navigate to Products → Categories in the sidebar to see all your root categories.
The list shows a table with the following columns:
| Column | Description |
|---|---|
| Name | The category name with an avatar circle showing the first letter, plus the category code below. |
| Type | Badge showing Automatic (blue) or Manual (neutral). |
| Status | Badge showing Published (green), Draft, Inactive, or Archived. |
| Subcategories | The number of direct child categories. |
Use the search bar to filter categories by name or code. Click any row to open the category editor.
Creating a root category
- On the category list, click Create Category.
- A modal opens with the following fields:
| Field | Required | Description |
|---|---|---|
| Name | Yes | The category display name. |
| Status | No | Initial status — Published, Draft, Inactive, or Archived. |
| Type | No | Manual or Automatic. Determines how products are assigned. |
- Click Create. You'll be redirected to the category editor.
The category editor
When you open a category, you see a two-pane layout:
Left sidebar — Category tree
The sidebar shows the full category tree starting from the root. You can:
- Expand/collapse branches by clicking the chevron on parent nodes.
- Search categories using the search bar — switches to a flat filtered list showing the full breadcrumb path.
- Add a subcategory by hovering over a node and clicking the + button.
- Delete a category by hovering and clicking the trash button (not available for root categories).
- Expand All / Collapse All using the buttons at the bottom.
Each tree node shows:
- A folder icon (if it has children) or file icon (if it's a leaf)
- The category name
- An auto badge if it's an automatic category
- A status badge if the status is inactive or archived
- The child count in parentheses
Right panel — Category details
The editor has several cards for different settings:
General information
| Field | Editable | Description |
|---|---|---|
| Name | Yes | The localized category name. |
| Code | No | Auto-generated identifier. Read-only after creation. |
| Status | Yes | Published, Draft, Inactive, or Archived. |
| Type | No | Manual or Automatic. Set during creation and cannot be changed. |
| Handle (URL slug) | Yes | The URL-friendly slug. Localized — can differ per language. |
| Anchor category | Yes | Toggle that enables filter aggregation from all subcategories. When on, the category collects filter attributes from its entire subtree. |
| Google Taxonomy | Yes | Map to a Google product category for feed optimization (e.g., "Furniture > Sofas"). |
| Facebook Taxonomy | Yes | Map to a Facebook product category (e.g., "furniture"). |
Product preview
At the bottom of the editor, a product preview card shows which products belong to this category:
- Select a market to see market-specific results.
- Click Refresh to update the preview.
- The preview table shows product image, name, SKU, price (with strikethrough for discounted items), discount percentage, and stock level.
- Pagination shows 20 products per page with Previous/Next navigation.
Saving changes
An unsaved changes bar appears when you modify any field. Click Save to persist your changes, or Undo to revert to the last saved state.
Creating subcategories
You can create subcategories directly from the category tree:
- Hover over any category node in the tree sidebar.
- Click the + button.
- A modal opens showing the parent category name.
- Enter the subcategory details:
| Field | Required | Description |
|---|---|---|
| Name | Yes | The subcategory name. |
| Status | No | Published, Draft, or Inactive. |
| Type | No | Manual or Automatic. |
- Click Create. The new subcategory appears in the tree.
Deleting categories
- Hover over a category in the tree sidebar.
- Click the trash button (not available for root categories).
- A confirmation modal warns that subcategories may also be affected.
- Click Delete to confirm.
Assigning products to categories
Products are assigned to categories from the product editor:
- Open a product and go to the Overview tab.
- In the Definition card, click Categories.
- Browse the category tree in the picker and select categories.
- Save the product.
Products can belong to multiple categories. They also inherit parent categories automatically — if a product is in "Sofas" under "Living Room" → "Furniture", it inherits all three categories.
Best practices
- Keep trees shallow — Aim for 2–3 levels of depth. Deeper structures are harder to navigate.
- Use consistent naming — Category names often appear in storefront navigation, so keep them clear and customer-friendly.
- Set up anchor categories — Enable the anchor toggle on parent categories that should aggregate filter attributes from subcategories.
- Map taxonomies early — Setting up Google and Facebook taxonomy mappings helps with product feed optimization from the start.
- Use status for lifecycle management — Set categories to Draft while building them, then publish when ready.