Configure Product Catalogs and Categories
Catalogs and Categories allow you to segment products to expose them in a differentiated way (e.g. different markets or specific channels like Shopify vs Amazon).
For example, you can create catalogs with specific categories for the Asian market, different from those used for the American market. Or structure a catalog optimized for Shopify, distinct from one designed for Amazon.
To manage Catalogs and Categories you must be an Administrator or have the "Can manage product data modeling" permission
Catalog Management
Create a Catalog
- Navigate to Platform Settings → Products → Catalogs and Categories.
- Click Add catalog in the upper right.
- Enter the Catalog code: an alphanumeric string with hyphens (-) as separators. Spaces are automatically normalized to hyphens.
- Click Create catalog to confirm.
- The catalog name can be translated for each active locale on the platform by editing the catalog (gear icon).
Delete a Catalog
Click on the actions icon (⚙) corresponding to the catalog and select Delete. A confirmation window opens asking you to type the catalog code before proceeding.
Category Management
Create a Category
You can create a category starting from the New category button (for the first level), or by using the contextual menu of an existing Catalog or Category to automatically generate a nested subcategory.
In all three cases, the Add new category overlay opens with the following fields:
- Category label: Enter the localized name (visible only if you have selected an active language).
- Category code: Unique alphanumeric identifier (Max 50 characters). Spaces are converted to hyphens (-). Not editable after saving.
- Catalog: Select the destination catalog (pre-filled if you use modes 2 or 3).
- Parent category: Defines the hierarchical "parent". It is manually searchable if you are creating a root category.
- Path preview: Check this read-only field to verify the complete Path (from catalog to category) before saving.
- The category name can be translated for each active locale on the platform by editing the category (··· icon).
Delete a Category
You can delete a category individually from its Three dots (···) menu, or perform a bulk deletion by selecting the checkboxes of the categories to delete; in both cases, the action automatically includes all nested subcategories.
Advanced
Filter Products by Category
From the Catalogs and Categories page, the product counter next to each category is clickable. Clicking it takes you directly to the product list filtered by that category.
Copy the Code or Path of a Category
Click on the contextual menu (···) of the category and select Copy codes. A modal opens with the following fields:
- Category code: the unique code of the category.
- Complete path: the complete hierarchical path by code, from the catalog to the category.
Both fields can be copied to the clipboard using the copy icon. A confirmation message notifies you of the successful copy.
Move a Category
The Move function is accessible from the contextual menu (···) of each category and allows you to change its position in the tree in two ways.
Reorder within the same parent
Change the order of a category among its siblings, without changing the parent category.
- Click Move from the category contextual menu.
- Use the up and down arrows to redefine the position among the sibling categories.
- Click Save changes to apply the new order.
The category remains under the same parent: only its position in the list changes.
Move under a different parent
Move the category under a different parent category within the same catalog.
- Click Move from the category contextual menu.
- Change the Parent category via the drop-down menu.
- Click Save changes to confirm.
Move constraints
- Categories cannot be moved between different catalogs. undefined
- Categories cannot be moved within their own children (only up or sideways in the tree).
- Structural limits (maximum depth and unique path) must be respected.
If one of the constraints is violated, an error message is shown and the changes cannot be saved.
When the move is successful:
- A confirmation notification is shown.
- The table automatically scrolls to the new position of the moved category.
Technical Limits and Constraints
The following table summarizes the main structural limits to be respected during configuration.
| Parameter | Limit / Constraint | Note |
|---|---|---|
| Categories per catalog | Max 500 total | Regardless of hierarchical level |
| Direct children per node | Max 15 subcategories | For each parent category |
| Tree depth | Max 10 levels | Counting from the catalog as root |
| Catalog / category code | Max 50 alphanumeric characters | Spaces are automatically converted to hyphens (-) |
| Code | Not editable after creation | If incorrect, delete and recreate the item |