Categories

Managing categories

Create, edit, and organize your category tree in Avvyr.

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:

ColumnDescription
NameThe category name with an avatar circle showing the first letter, plus the category code below.
TypeBadge showing Automatic (blue) or Manual (neutral).
StatusBadge showing Published (green), Draft, Inactive, or Archived.
SubcategoriesThe 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

  1. On the category list, click Create Category.
  2. A modal opens with the following fields:
FieldRequiredDescription
NameYesThe category display name.
StatusNoInitial status — Published, Draft, Inactive, or Archived.
TypeNoManual or Automatic. Determines how products are assigned.
  1. Click Create. You'll be redirected to the category editor.

The category editor

When you open a category, you see a two-pane layout:

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

FieldEditableDescription
NameYesThe localized category name.
CodeNoAuto-generated identifier. Read-only after creation.
StatusYesPublished, Draft, Inactive, or Archived.
TypeNoManual or Automatic. Set during creation and cannot be changed.
Handle (URL slug)YesThe URL-friendly slug. Localized — can differ per language.
Anchor categoryYesToggle that enables filter aggregation from all subcategories. When on, the category collects filter attributes from its entire subtree.
Google TaxonomyYesMap to a Google product category for feed optimization (e.g., "Furniture > Sofas").
Facebook TaxonomyYesMap 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:

  1. Hover over any category node in the tree sidebar.
  2. Click the + button.
  3. A modal opens showing the parent category name.
  4. Enter the subcategory details:
FieldRequiredDescription
NameYesThe subcategory name.
StatusNoPublished, Draft, or Inactive.
TypeNoManual or Automatic.
  1. Click Create. The new subcategory appears in the tree.

Deleting categories

  1. Hover over a category in the tree sidebar.
  2. Click the trash button (not available for root categories).
  3. A confirmation modal warns that subcategories may also be affected.
  4. Click Delete to confirm.
Deleting a category may affect its subcategories. Make sure to review the tree structure before deleting.

Assigning products to categories

Products are assigned to categories from the product editor:

  1. Open a product and go to the Overview tab.
  2. In the Definition card, click Categories.
  3. Browse the category tree in the picker and select categories.
  4. 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.
Copyright © 2026