↑↓ selectEnter openEsc close

    1. Elbuz

    How to build a catalog category tree

    6 min readUpdated

    Elbuz keeps your own catalog sections as a tree. A category sets a product's website section, markup and exports. Build the tree once; products from price lists then fall into it.

    When you need this:

    • No catalog yet: add twenty subcategories as one list; they take page settings from the parent.
    • Rearranging branches: a moved branch keeps its products and page addresses.
    • Removing clutter: the “Without products” filter above the table shows categories safe to delete.
    • A showcase collection: a parity category shows a product in one more section without moving it.

    Where to start: create the top-level sections with the “Add” button in the “Categories” window.

    What the category tree can do

    Why you need the tree and why it comes before price lists

    A category is a product's address in your store. It sets the website section, markup, exports and the rules by which supplier price list data reaches the product. A price list row with no matching catalog category is not added to the catalog, so build the tree before loading price lists. One exception: with “Add categories” on in the catalog update settings, the program creates categories from the price list itself (base catalog update).

    Which of your edits survive the next update with “Add categories”. Before creating a category from a price list, the program looks for it in the catalog three ways: by the name it once arrived under from this price list; by the internal ID it got on creation from the price list; by its current full name with path in the tree. A found category is not created again, and its name is not overwritten.

    • If a price list created the category and you renamed it, it is found by its original price list name or by its ID. No duplicate appears, and your name stays.
    • If a price list created the category and you dragged it to another branch, the move survives the run. The program resets the parent of such categories every time, but to the parent the drag recorded, so the category does not go back to its old place.
    • If you created the category yourself and the price list “picked it up” only because the full name matched, after a rename or move there is no match anymore, and the next run creates a new category with the price list name.
    • If you deleted a category created from a price list, the next run creates it again as a new category, and the price list rows go into it.

    After the “Adding categories” step, the program rebuilds the ancestor chains and full names of the whole tree, and every category is marked as changed: the next export includes all categories, not only new ones.

    The tree has no depth limit: neither the program nor the database caps nesting. You set the limit yourself: the deeper the tree, the longer it takes a buyer to reach a product and the harder it is for you to work with categories.

    The hierarchy is stored twice: each category records its direct parent and, separately, its whole ancestor chain up to the root. The chain quickly answers “which products are in this branch, including subcategories”. The category's full name is also copied into the products, so when you rename or move a branch, it rewrites the name across the whole branch.

    What the counters above the tree and in the card show

    The Categories window: summary tiles on top, the category tree on the left, the overview screen on the right
    1Total categories
    2Products without category
    3Add
    4Table view
    5Category list (tree root)
    1. Total categories — how many categories the catalog has.
    2. Products without category — products not yet placed in any category.
    3. Add — opens the dialog for a new category.
    4. Table view — shows all categories as a table.
    5. Category list — the root of the tree; nothing is selected, so the overview is shown on the right.

    Above the tree there are five tiles: “Total categories”, “Active”, “Disabled”, “Products in categories” and “Products without category”. The last one is highlighted in yellow when it is not zero.

    Two more numbers: the badge to the right of the category name in the tree and the counter in the category card. Both count the whole branch including subcategories: products whose main category is in the branch. Products that sit in a category only as a link from a parity collection are not counted.

    The badge is a stored number: the program recalculates it after loading price lists, imports and catalog updates. The card counts each time you open it. If the numbers differ, go by the card.

    Category tree with branch counters and the product count in the selected category card
    1Branch counter of the parent category
    2Counter of a subcategory
    3Products in the category card
    1. The counter next to the parent category counts products of the whole branch, so it equals the number in the card.
    2. A subcategory counter shows the products of that subcategory.
    3. The card shows the same product count as the tree counter of the selected category.

    How to find a category in the tree

    The “Category search” field sits right below the buttons. It works from two characters: with one letter the filter does not run at all, and that is not lag but a threshold in the code. Escape or an empty field clears the filter.

    Before the first search, the program expands the whole tree; otherwise the filter would not see collapsed branches. Non-matching nodes are hidden, and parent nodes show how many matches they contain. In a catalog of several hundred categories, this gets you to the right branch faster than expanding levels by hand.

    Tree filtered by the search
    1Category search
    2Match counter at the parent
    3Found category
    1. Category search — the field where you type part of a name.
    2. Match counter — shows how many matches are inside the parent node.
    3. Found category — the matching part of the name is highlighted.

    The three-line button to the right of the trash can is “Additional Operations”. It has four items: “Expand all categories”, “Collapse all categories”, “Refresh list” and, after a divider, “Match categories and attributes with marketplaces”, which is a different window and a different topic.

    Additional operations menu next to the buttons above the tree
    1Expand all categories
    2Refresh list
    3Match categories and attributes with marketplaces
    1. Expand all categories — opens every branch of the tree.
    2. Refresh list — reloads the tree from the database.
    3. Match categories and attributes with marketplaces — the last item, opens the marketplace mapping.

    Two small things that save time every day: you can drag the border between the tree and the right half with the mouse (double-clicking it collapses the panel), and the last opened category is remembered, so the window opens on it next time.

    What is on the overview screen

    When the “Category list” root is selected in the tree, or nothing is selected, the right half shows the overview screen. Clicking any category replaces it with that category's card: content, , markups and page settings, with changes saved on the fly.

    The overview screen has three cards. The first, “How the directory works”, gives four steps for beginners; “Add” in the first step is clickable and presses the create category button. The second, “Markup / Discount (global settings for all products)”, is collapsed by default and holds store-wide rules; a rule in a category's own card takes priority. Pricing is covered in a separate article.

    The third card, “Catalog tools”, has tiles leading to related windows: “Translate into other languages”, “Marketplace mapping”, “Size charts”, “Bulk text generation using AI”, “AI product index” and three widget settings: configurator, smart assistant and smart search. “Size charts” (how to manage them) open in their own window, separate from the “Category list”; both can stay open.

    Catalog tools card on the overview screen
    1Apply parity categories
    2Marketplace mapping
    3Translate into other languages
    1. Apply parity categories — runs product distribution across the whole catalog, not a window.
    2. Marketplace mapping — matches categories with marketplace categories.
    3. Translate into other languages — translates category names and descriptions.

    The “Apply parity categories” tile does not open a window. It distributes products by parity rules across the whole catalog, and asks before starting: “Products of the whole catalog will be distributed across parity (showcase) categories by the rules. This is a bulk operation and may take a while.” When it finishes, you see “Operation completed successfully”.

    The category card has a nearby “Parity categories” tile, and that one opens the rule settings window. The names now differ: one says what it will do, the other says where it leads.

    How to ask AI about a category's health

    In the category card header, next to “AI generation”, there is a “✦ AI” button. It opens the consultant chat, which already knows which category you mean, and offers four questions:

    • “Category health”: how many products in the category and its subcategories lack a photo, description, price or stock, and which subcategories are empty. The consultant offers to delete empty subcategories as a plan with a confirm button;
    • “Move products”: helps move products to another category, asking which ones and where;
    • “Set an attribute for all products”: shows the category's attributes, asks which one and what value, and prepares a change plan;
    • “How the category goes to the export”: which marketplace categories it is mapped to, which export templates it goes into and what is missing.
    AI consultant window opened from the category card with hints about this record
    1About this record
    2Category hint
    3Question field
    1. About this record — hints tied to the open category.
    2. Category hint — a ready-made action such as category health or moving products.
    3. Question field — where you can type your own question.

    A hint appears only when there is data and permission for it:

    • “Category health”: if there are problem products or empty subcategories; the number next to it is problem products plus empty subcategories;
    • “Move products”: if the category has products; the number next to it is the category's products;
    • “Set an attribute for all products”: if the category has attributes;
    • “How the category goes to the export”: if you can open the export window with the right to test a template.

    The consultant offers to delete empty subcategories only to users allowed to delete categories in the tree. The consultant changes nothing without your confirmation. Phrases for the consultant are in the AI consultant article.

    How to check several categories in the selection window

    This window opens from other settings to limit an action to some catalog categories: base catalog update settings for a price list, the export template filter, text ignore and replace rules, a parser preset, smart search widget settings. It only stores the category list for that setting; it does not move products or change their category.

    How to check several categories and save:

    1. Select the checkboxes next to the categories you need. A checkbox on a parent category checks its whole branch; a partly checked branch shows a gray square.
    2. To find a category by name, type it in the “Category search” field above the tree. Parent nodes show a match counter.
    3. Click “Save” at the top of the window. The window closes, and the list in the window you came from updates.
    Select product categories window with search and checkboxes
    1Save
    2Category search
    3Checked category
    4Partially checked parent
    1. Save — applies the chosen categories to the setting (not pressed).
    2. Category search — filters the tree and highlights matches.
    3. Checked category — the category ticked for the filter.
    4. Partially checked parent — a parent with only some children selected.

    Closing the window with the X discards the selection. The “Additional operations” menu next to the button has “Expand all categories”, “Collapse all categories” and “Refresh list”. When the window is opened from price list settings, it also has “Show all categories”: at first the tree shows only categories that this price list's products are distributed to.

    A product's main category is not set in this window: you change it in the product card or with a bulk operation in the product list (bulk editing). In the export template filter, you can also make the same choice in a table: the “Activity” column and the “Save” button.

    Scenarios

    Build a catalog from scratch

    What to do. Work through the list from top to bottom; each step is detailed in the article on creating categories.

    What to do

    Result. A tree with top-level sections and subcategories that share the same page settings.

    Clear empty categories from the catalog

    What to do. Open “Table view”, turn on the “Without products” filter and delete candidates from top to bottom, checking the counter in the card: the steps.

    Result. Empty branches disappear entirely, products stay where they are.

    Remove a product line from the website

    What to do. With one store, turn off “Category activity” in the card (disabling). With several stores, to hide it in just one, clear that store in the “Stores” block (a category in one store).

    Result. Disabling turns off the branch together with its products; clearing a store removes the category only from that store and does not change statuses.

    What to do when the tree shows something wrong

    What you seeWhyWhat to do
    The badge in the tree and the product count in the category card differ The badge is a stored number, recalculated after loads and catalog updates; the card counts live Go by the card (counters)
    “Error loading!” instead of the tree The tree response did not arrive or arrived corrupted Close and reopen the window; if it happens again, contact support
    “No data!” in the tree The catalog has no categories Create the first one with the “Add” button (creating a category)

    FAQ

    How many nesting levels can I have?

    Neither the program nor the database has a limit. A deep tree makes navigation harder for buyers and makes your own work with categories harder.

    Can the program create categories from a price list on its own?

    Yes, if “Add categories” is turned on in the catalog update settings. Which of your edits survive the next run is explained in the note.

    Can I match supplier categories to mine here?

    No: price list categories are a separate directory with their own window. How to link them to your tree: Price list category matching.

    What happens to products if I delete a category?

    Products whose main category it is are deleted for good, together with the whole branch. To keep them, first move the products to another category. Details: what disappears with a category.

    Why doesn't quick search (Ctrl+K) find a category?

    Quick search covers products, contacts and documents, not categories. Use the “Category search” field above the tree: how to find a category.

    Where to find it and who has access

    Menu
    Directories → Categories
    Desktop
    the “Categories” shortcut
    Table version
    the “Table view” button above the tree
    From the products window
    Base product catalog → Products → “Additional Operations” above the tree → “Category list”
    Access right
    the “Categories” window; “Add” and “Delete category” are separate group permissions
    Prepare
    nothing; if categories will come from an import, run the import first

    The “Category list” has no menu item of its own: this window opens only from the two places named above.

    Quick search (Ctrl+K) does not find categories: it covers products, contacts and documents, but not categories.

    Dragging, sort order and editing in the “Category list” table have no separate permission: anyone who can open the window can do them. So access to “Categories” means access to the whole catalog structure. The “Tab "Markup / Discount"” permission hides the global markup card on the overview screen; the window's other permissions control the category card.

    Left menu with the Directories branch expanded
    1Categories
    1. Categories — the item under Directories that opens the category tree window.

    Related topics

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free