↑↓ selectEnter openEsc close

    1. Elbuz

    How to create, rename and move a category

    11 min readUpdated

    Elbuz creates a category inside the selected branch, moves branches by drag and drop, and renames categories while products, markups and page addresses stay put.

    When you need this:

    • Twenty sections to add: a column of names becomes subcategories in one click.
    • Subcategories should look the same: a new category takes its page settings from the parent.
    • A name is out of date: the new name saves itself and goes out with the next export; the page address stays.
    • A branch is in the wrong place: drag it. Products stay put, website links don't break.

    Where to start: select the parent category and click “Add”.

    What you can do

    How to create a category

    A new category is always created inside the selected node. This is the main thing to remember: first click the category in the tree that should become the parent, and only then click “Add”. If nothing is selected, the program selects the “Category list” root itself, and the new category becomes a top-level one.

    The “Adding a category” dialog opens. It contains:

    • the “Parent category” line: read-only, shows the full path of the selected node. There is no such line for the root;
    • the “Category name” field with the placeholder “Enter a category name”. If the field is empty, a red line “You must enter a category name!” appears and the dialog stays open;
    • the “Create categories in bulk” checkbox, described below.
    Dialog “Adding a category” with the parent category path, the name field and the bulk creation checkbox
    1Parent category
    2Category name
    3Create categories in bulk
    1. Parent category — the full path of the selected node, here Computer Peripherals / Input Devices; the new category is created inside it.
    2. Category name — type the name here; the hint inside the field tells what to enter.
    3. Create categories in bulk — switch that changes how the text is parsed; left off by default.

    The new category appears in the tree right away as active, and the operation log gets a creation entry. The program creates the page address (SEO URL) itself, but only if the address generator is on: Directories → Base product catalog → Generator, the “Generator enabled” checkbox. With the generator off, set the address by hand in the card.

    What a new category takes from its parent

    A new category inherits all category page settings from its parent: how many products per row and per page, whether to show the price, description, “Buy” button, comparison, wishlist, reviews, specifications, the Q&A block, which template file to use, plus the element type. Set up the parent once, and you get identical subcategories with no manual work.

    No content is inherited: markups, descriptions, SEO fields and images are empty in the new category. A new category is created active, with the export checkbox on.

    Creating in bulk

    The “Create categories in bulk” checkbox turns the name field into a list: each line becomes a separate category under the same parent. Twenty subsections take one click instead of twenty dialogs. The program skips blank lines and duplicates itself.

    All three delimiters work. The checkbox hint lists them: “delimiter: newline or semicolon or tab character”. The program counts each character in the text and splits by the most frequent one. The list ZZS1;ZZS2;ZZS3 gives three categories, a column from a text file gives as many as it has lines, and a column copied from Excel splits by tabs.

    Keep in mind: if the names themselves contain semicolons and there are few lines, semicolons may win, and the split won't happen where you expected. In that case, remove the extra characters or paste the names strictly as a column.

    A category with this name already exists

    The program won't let you create two categories with the same name under one parent. No new node appears in the tree, and an orange message gives the reason: “Category with the specified name already exists”. If you created categories as a batch, the message comes for each name that failed.

    Find the existing category with the search above the tree. The check compares names in the store's main language and ignores case: with “Mice” in place, “mice” is a duplicate. But “Gadgets” and “Gadget” are different names, so the second one is created. Identical names under different parents are allowed: “Accessories” under laptops and “Accessories” under smartphones don't conflict.

    How to rename a category

    To rename a category, click it in the tree, and the category card opens on the right. The name is in the “Content” section, in the “Category name” field. You can't change the name right in the tree node: double-clicking a node doesn't edit anything.

    The card has no “Save” button. Your change goes to the database by itself, about a second after you leave the field with Tab or a click elsewhere. A status appears at the bottom of the card: first “Saving…”, then “Saved” with the time. If you see “Not saved” instead, the name didn't reach the database.

    While the cursor is in the field, the new name hasn't been sent yet. Leaving the field is what triggers saving. Type a name and reload the page right away, and the change is lost. Leave the field first and wait for “Saved”. Clicking another category in the tree or closing the “Categories” window sends a pending change by itself.

    If your store has several languages, each language has its own “Category name” field. The tree, the card title and the full name show the name in the main language. Names in other languages don't change by themselves: each non-main language field has a “Translate from the main language” button, or you can type the translation by hand.

    The Content section of the category card: the English block is collapsed and the Deutsch block is open with the category name and its translate icon
    1Collapsed main-language block
    2Category name in Deutsch
    3Translate from the main language
    1. The collapsed English block with its fill badge — the main language of the category name.
    2. The Category name field for the second language (Deutsch), holding the translated name.
    3. The Translate from the main language icon next to the label of the second-language field.

    The card title picks up the new name immediately as you type. The node in the tree on the left shows the old name until the tree reloads: click “Refresh list” in the “Additional Operations” menu or reopen the window.

    The second place to rename a category is the “Category list” table: double-click a cell in the “Name” column. There you can edit only the main-language name; other languages are edited only in the card.

    What changes after renaming and what doesn't

    • Products, markups, price list rules and marketplace codes stay in place. They are all tied to the category itself, not to its name. Products don't move, price list distribution rules and category matching keep placing products in the same category, and marketplace matching stays intact.
    • The page address on the website (SEO URL) doesn't change. The “SEO URL” field in the card keeps its value, so links already posted elsewhere don't break. There's one exception: if the SEO URL field is empty and the address generator is on, the program builds an address from the new name.
    • SEO fields aren't rewritten automatically. “HTML H1 tag”, “HTML Title tag”, the description and “Category name #2” are separate fields in the section of the same card. If they contained the old name, fix them by hand.
    • The next export sends the new name. After saving, the category is marked as changed, and the export sends it to the website or marketplace again. A name edit in the “Category list” table does the same.
    • No duplicate check here. Unlike creating, renaming won't stop you if the same parent already has a category with that name: you can end up with two identical names side by side.

    The full name updates together with the name. The path from the root, “Computer peripherals / Input devices / Computer mouse”, is a separate field, and each product keeps a copy of it for exports.

    After renaming in the card or the table, the program immediately rewrites the full name of the category, all its subcategories and the copy in the branch's products. Rename a parent, and the new name shows right away in the “Parent category” line of subcategory cards and in the table's “Full name” column.

    How to move a branch or change the order

    You drag categories in the tree with the mouse, and the same drag does two different things depending on where you release the button.

    • Drop between nodes of the same parent: only the sort order changes. The hint next to the cursor: “Sort order will change”.
    • Drop onto a node, or between nodes of another branch: the category moves to a new parent. The hint: “Will become a subcategory of “‹name›””.
    • Forbidden drop: onto itself or into its own subcategory. The hint: “Cannot move here”, and nothing happens.

    The line isn't between “dropped between” and “dropped onto” but between “same parent” and “different parent”. Drop a category between two children of another branch, and it becomes a child of their parent: a move, not a re-sort. So go by the cursor hint, not by where you aim: it names the result before you release.

    There's deliberately no confirmation when the parent changes: the same hint shows your intent in advance. After a successful move, the message “Moved into “‹name›”” appears; the tree root is called the same there as in the tree, “Category list”.

    The server checks the move again and rejects it if the parent is the category itself, if the category no longer exists, or if the new parent descends from the category you're dragging. You then see a red “Move rejected: invalid parent”. This prevents a loop in the hierarchy that would force you to restore the tree by hand.

    The result depends on the new parent, not on the drop point: the same parent means only re-sorting, a different one means a move that the server checks again
    The category itselfor its subcategorySame parentDifferent parentParent no longer existsor is a descendant of thecategoryServer errorCheck passedDragged category releasedWho becomes the parent?Hint “Cannot move here”,nothing changes after releaseOnly thesort order changesServer checksthe new parent“Move rejected:invalid parent”tree unchanged“Status: … Error: …” windowtree unchangedThe branch movesto the new parentFull name updatesacross the branch and in products.Page address and productsstay as they were“Moved into “‹name›””
    • Start or end
    • Action or result
    • Decision: the path depends on the answer

    What happens to products when you move a branch

    Nothing. Products don't move anywhere and don't change: they stay in their categories and simply end up in a new place in the tree together with the branch. The category's website address doesn't change either: the SEO URL is tied to the category itself, not to its parents, so links already posted elsewhere don't break.

    Only the position in the structure and the sort order change: after the drop, the program recalculates the order based on how the new parent's children actually stand.

    The full path is correct everywhere right after a move. The program goes through the whole moved branch: the new path appears immediately in the “Full name” column of the table view, in subcategory cards, and in the path copy that each product in the branch keeps and that goes into exports.

    Scenarios

    Add sections from a supplier's list with identical pages

    What to do. Select the “Category list” root, click “Add” and create the top section. Click it and set up the category page in its card: products per row and per page, blocks to show, the template file. Then, with that section still selected, click “Add” again, turn on “Create categories in bulk” and paste the names as a column.

    What you get. Each line becomes a subcategory of that section with its page settings. New categories are active, with “Export to file (to website)” on. Blank lines and duplicates within the list are skipped. The program builds the page address itself if “Generator enabled” is checked in the URL Generator.

    What you don't get. The parent's markups, descriptions, SEO fields and images aren't copied. A name that already exists in this section isn't created twice: it gets “Category with the specified name already exists”, and the rest of the list is created. Later changes to the section's card don't reach existing subcategories: settings are copied only at creation.

    Restructure the catalog without breaking links

    What to do. Drag the branch with the mouse and release the button when the hint next to the cursor says “Will become a subcategory of “‹name›””.

    What you get. The whole branch moves to the new parent, with its subcategories. The full name updates in the category, its subcategories and the copy kept by the branch's products; these categories are marked as changed and go out with the next export. The sort order is recalculated by how the new parent's children stand in the tree.

    What you don't get. The page address (SEO URL) doesn't change, and products don't move to other categories. There's no “Are you sure?” question: the move applies as soon as you release the button.

    What to do when a category isn't created or moved

    What you seeWhyWhat to do
    I clicked “Add” and entered a name, but nothing appeared in the tree, and a message popped up at the top Orange “Category with the specified name already exists”: this parent already has that name. Red “Not enough permissions for this operation!”: your group lacks the right to the “Add category” button In the first case, find the existing category with the search above the tree; in the second, contact the account owner (who has access)
    “You must enter a category name!” The “Category name” field is empty Enter a name; the dialog stays open while the field is empty
    The list split in the wrong place: you got two categories or one instead of three Bulk creation splits the text by the most frequent delimiter: line break, semicolon or tab. If semicolons appear inside the names, they may win Remove the extra characters from the names or paste the list strictly as a column, one name per line (bulk creation)
    “Cannot move here”: a hint next to the cursor The category is being dropped onto itself or into its own subcategory Pick a different parent (dragging)
    “Move rejected: invalid parent” The same thing, but caught by the server: the tree on screen is behind the database Click “Refresh list” in the additional operations menu and try again
    I changed the category name and reloaded the page, and the field shows the old name again The page was reloaded while the cursor was still in the field: saving starts when you leave the field Enter the name again, press Tab and wait for “Saved” at the bottom of the card (renaming)

    FAQ

    Do website links break after moving a category?

    No. The page address is tied to the category itself, not to its parents, so it stays the same after the branch moves. Products don't move anywhere. Learn more: moving a branch.

    Which delimiters does bulk category creation understand?

    Newline, semicolon and tab: the program splits by whichever character appears most in the text. If names contain semicolons, paste the list as a column. Learn more: bulk creation.

    Will a new subcategory inherit the parent's markup?

    No: markups, descriptions, SEO fields and images are empty in a new category. To copy rules down the branch, see category markup.

    The card shows the new name, but the tree shows the old one. Wasn't the name saved?

    It was: the tree shows the new name after it reloads. Click “Refresh list” in the “Additional Operations” menu or reopen the window.

    Can I change a product's category here?

    No, this is where you change the tree. You change a product's category in its card or with a bulk operation in the product list: bulk editing.

    Where to find it and who has access

    Menu
    Directories → Categories
    Renaming
    the category card, “Content” section, or the “Category list” table
    Access right
    the “Add” button: the group right Button "Add Category"

    Dragging isn't restricted by a separate right. The right “Tab "Main data": category name” hides the “Category name” field in the card, but in the “Category list” table you can change the name without it.

    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