↑↓ selectEnter openEsc close

    1. Elbuz

    How to disable or delete a category without losing products

    16 min readUpdated

    Elbuz takes a product line off your site in one step: disabling a category disables its subcategories and their products. Deletion removes the branch's products for good, so move them first and find empty categories with a ready-made filter.

    When you need this:

    • A product line is discontinued — the “Category activity” switch disables the branch with its products.
    • The category is redundant, the products aren't — move the products, then delete the empty category.
    • Many empty categories — the “Without products” filter above the table finds them.
    • Deletion was interrupted — run it again.

    Where to start: see what disappears with a category and the counter in its card.

    What you can do

    How to disable a category with its whole branch

    You disable a category in its card, not in the tree, with the “Category activity” switch. In the tree, a disabled category is shown dimmed.

    This switch, and only this one, disables the whole branch: all subcategories and their products become inactive along with the category. Handy for taking a product line off the site — one action instead of a thousand products. The “Active” checkbox cleared in the “Category list” table works differently — see the section about the table.

    Turning the category back on restores nothing but the category itself. The cascade works one way: down, not up. Products and subcategories disabled together with the parent stay disabled, and the product line still won't show on the site.

    The interface doesn't mention this anywhere, and this is where people lose the most time: the category is active and looks normal in the tree, but its products are gone from the site. To bring the branch back, enable the products separately with a bulk action in the base catalog product list.

    So treat disabling a category as “remove for good” rather than “remove for a week”: bringing it back costs a separate bulk action on the products. If you have several shops, there's a cheaper way to hide a section from the storefront — remove the category from a shop in its card: product statuses don't change.

    What happens to products with each of the three category actions
    Turned offthe switch in the cardDragged itto another nodeDeleted itwith the trash buttonCategory in the treeWhat you didThe category, its subcategoriesand all products of the branchbecome inactiveTurning it back onrestores only the category itself.Products are enabled separatelyOnly the positionin the tree and the sort order changeProducts stay in their categories,the page URL doesn't change.The full name is updatedacross the whole branch at onceThe category, its subcategoriesand all products of the branchare deleted for goodAlong with descriptions, photos,attributesand price list rules for this category.This can't be undone
    • Action or result
    • Decision: the path depends on the answer

    What disappears along with a category

    The trash button above the tree deletes the selected category. The dialog is called “Deleting a category” and asks “Delete category "‹name›"?”; the confirm button is “Yes”. Then you'll see “Please wait, deleting the category and its products...”, and when it's done — “Category deleted”.

    Dialog
    1Deleting a category
    2Category name in the question
    3Yes
    1. Dialog title — confirms that a single category is being deleted.
    2. The question names the selected category (here "Mouse Pad"; docsdemo has it instead of the scenario's id 177 mouse pad name).
    3. The "Yes" button deletes the category; "Cancel" next to it closes the dialog without changes.
    The left branch is a regular category, the right one is the root, where nothing starts without the word DELETE; after that, both wait for the server's response
    Regular categoryRoot “Category list”NoYesYesDeclined in the dialogDeclined in the dialogMissing permissionsor refusalServer errorSuccessClicked the trash button above thetreeWhat is selected in the tree?“Deleting a category” dialog“Delete all categoriesand products” dialogwith a field for the wordWas the word DELETE typed?“The confirmation word does notmatch- deletion cancelled”Server responseThe dialog closes,nothing is deletedRed message,the category stays in the tree“Status: … Error: …” window,the tree shows the state beforedeletion“Category deleted”,the tree refreshes
    • Start or end
    • Action or result
    • Decision: the path depends on the answer

    The whole branch is deleted together with its products, and you can't undo it. Along with the category and all its subcategories, these disappear: products, their descriptions, attributes, photos (the files too, not just the records), videos, discounts, promotions, questions and answers, page URLs and shop assignments. There's no trash to collect them, and nothing can bring them back.

    The dialog doesn't warn you about products — it shows only the category name. So before you click, check the counter in the category card: it shows the number of products in the whole branch, not just in the category itself.

    And something you can't see from the window at all: if your shop is connected through a tunnel and the export template has on-the-fly category deletion turned on, the category and its products also disappear from the site right away, without waiting for the next export.

    Price list settings made specifically for the category are deleted along with it. So deletion also rolls back part of the work in the distribution rules and price list category matching windows:

    • rules that distribute products into this category, text parsing and replacement rules, and markup rules disappear;
    • price list rows placed in this category lose the link and become unassigned;
    • saved AI category matching results that pointed to this category are deleted, so the next price list import won't put these rows back into the deleted category.

    One more easy-to-miss case is a . Only products for which this category is the main one are deleted. A product that's in the collection as a mirror link stays in its regular category — only the collection and the link disappear. So you can delete a storefront parity category without losing products, but not the category where the products actually live.

    How to delete a category and keep its products

    The interface has no “delete the category but keep the products” action. Here's the order: first move the products to another category with a bulk action in the base catalog product list, and only then delete the empty category. An empty category is deleted without losing products, though the price list rules linked to it disappear anyway.

    How to remove empty categories

    The tree has no “Without products” filter — only the table does. Open it with the “Table view” button above the tree: the filter bar is above the grid, “Without products” is the third filter. Don't see it? Click “More” on the right of the bar or the “Filter settings” gear and put the filter back.

    Categories table with the
    1Without products
    2Number of products
    1. The "Without products" quick filter is active.
    2. The "Number of products" column shows 0 for the filtered category.

    There's no “delete all empty” button, and you can't select several rows in the table either: the trash button deletes one category at a time. Here's the order:

    1. Turn on “Without products” and sort the grid by the “Full name” column — subcategories will line up under their parents.
    2. For each candidate, check the counter in the category card in the tree: it counts the whole branch live. Zero means you can delete the whole branch; not zero means delete only the empty subcategories and keep the parent.
    3. Delete from the top down: a deleted parent category takes the whole empty branch with it, leaving fewer rows to delete by hand.

    A mistake here costs products: the “Number of products” column is a stored number, while deletion takes every product the branch has right now. That's why the counter in the card is what counts. Categories created by a price list will be created again on the next run if the price list has products for them again.

    How to clear the entire catalog

    If the root node “Category list” is selected, the trash button does something completely different. The dialog title changes to “Delete all categories and products”, it asks “Do you want to delete all categories and products in them?” and adds a field for the word DELETE. Confirming clears everything: all categories, all products with descriptions, photos, attributes, questions and answers, warehouse stock and shop assignments, and landing pages; counters reset, and category and product image folders are erased in cloud storage.

    Clearing the catalog is confirmed with a word. In the “Delete all categories and products” dialog, an input field sits under the question: “This will delete ALL categories and products with no way back. Type the word DELETE to confirm:”. Without it, “Yes” starts nothing: you get the red “The confirmation word does not match - deletion cancelled”.

    The Delete key presses the same trash button, but deliberately does nothing on the root, so the catalog can't be cleared by accident. For a regular category Delete works as usual, and the dialog can be confirmed from the keyboard. Check the title before pressing Enter: “Deleting a category” and “Delete all categories and products” are different things.

    The service keeps nightly backups of the whole database for the last week. You restore them by hand: “Account” → “System settings” → the “Other settings” section in the left column → the “Restore database backup” tile. You can't use them to undo a single action:

    • a backup takes the whole database back a day, orders and edits included;
    • erased image folders aren't in the backup at all.
    Dialog
    1Delete all categories and products
    2Question text
    1. Dialog title — the root node is selected, so the whole catalog would be deleted.
    2. The question asks whether to delete all categories and the products in them; the dialog also requires typing DELETE to confirm.

    What to do if deletion was interrupted

    Deleting a category is a single server request, not a task in the background queue. It has no “Stop” button, and it isn't written in one go but in separate steps, one after another:

    1. image files of the branch's categories are deleted, the names of the categories about to disappear are written to the operation log, and the page URLs of these categories are removed;
    2. photo files of products whose main category is in the branch are deleted, in batches of 500 products;
    3. the products themselves are deleted with descriptions, attributes, discounts and other data, along with the price list rules linked to these categories;
    4. the categories themselves are deleted from the database last: records, ancestor chains, names, shop assignments;
    5. finally, if on-the-fly deletion through a tunnel is on, the deleted items are also removed from the site.

    These steps have no common rollback: an interruption leaves exactly what managed to run. Categories go last, so if it broke during photos or products, the category stays in the tree and some of its products may already have lost their photo files. Reopen the “Categories” window, select the same category and run deletion again — it removes what's left. The code has no cap on the number of products in a branch, and Elbuz doesn't show in advance how long deletion will take.

    • If the server returned an error, a window with the text “Status: … Error: …” appears, and the category stays in the tree. At that moment the tree shows the state before deletion: to see what actually happened, reopen the “Categories” window.
    • If the server refused (for example, you lack permissions), a red message appears — “The category could not be deleted” or a message about permissions — and nothing is deleted.
    • The blue “Please wait, deleting the category…” disappears by itself after 200 seconds, even if the server is still working. That doesn't mean it's finished. It's finished when you see “Category deleted” and the node disappears from the tree.

    Category reindexing works the same way — one request, in steps. In the “System functions” window, “Reindex records” block, the “Base catalog categories” button rebuilds ancestor chains and full names of all categories, plus the full-name copy in products. It first erases full names and tree keys in all categories, then rebuilds them. Interrupted midway, it leaves some categories with an empty full name. Each run starts from scratch, so just run it again. Afterwards every category is marked as modified and goes into the next export again.

    If the server returned an error, the blue “Processing data, please wait” disappears, the buttons become active again and the red “Operation failed!” appears. Then just run the reindex again.

    Scenarios

    Take a product line off sale completely

    What to do. Click the category in the tree and turn off the “Category activity” switch in its card.

    What you get. The category itself, all its subcategories and all products whose main category is in this branch become inactive. All of them are marked as modified and go into the next export.

    What won't happen. Turning the switch back on doesn't enable the subcategories or the products. Products that are in the branch only as mirror links from a parity collection aren't disabled. And the “Active” column in the “Category list” table disables exactly one row, with no cascade.

    Remove a storefront collection without losing products

    What to do. Select the parity collection category in the tree, click the trash button and confirm with “Yes”.

    What you get. The collection with its subcategories disappears, along with the mirror links to products in it and the price list rules linked to these categories.

    What won't happen. Products whose main category is a different one aren't deleted: they stay in their categories with descriptions and photos. Only products whose main category is this collection or one of its subcategories are deleted, so check for those before deleting.

    What to do when products got disabled or disappeared

    What you seeWhyWhat to do
    I turned the category back on, but its products are still disabled The cascade works only for disabling — and only from the switch in the card Enable the products separately with a bulk action in the base catalog product list (disabling a category)
    “Please wait, deleting the category and its products...” Deletion is running normally: the branch's products are deleted for good Wait for “Category deleted”. You can't cancel or roll it back (deletion)

    FAQ

    I turned the category back on, but the products didn't come back. Is this a bug?

    No. Turning it on restores only the category itself; enable the subcategories and products separately with a bulk action in the base catalog product list. Learn more — disabling a category.

    I accidentally deleted a category with products — can I restore it from the trash?

    No, there's no trash for deleted categories. What's left is restoring a database backup, but it takes the whole database back a day and doesn't include image files. Learn more — about backups.

    Can I bulk delete empty base catalog categories?

    Not in one action: categories are deleted one at a time. The “Without products” filter above the table helps you find them, and an empty parent category takes the whole empty branch with it. The order — how to remove empty categories.

    How long will deleting a large branch take?

    Elbuz doesn't show this in advance, and there's no “Stop” button. The blue “Please wait…” disappears after 200 seconds, even if the server is still working; it's finished when you see “Category deleted”. Learn more — interrupted deletion.

    Will products that are in a category only as a link from a collection be deleted?

    No. Only products whose main category it is are deleted; a product with a mirror link stays in its own category. Learn more — what disappears along with a category.

    Where to find it and who has access

    Menu
    Directories → Categories → trash button above the tree
    Disabling
    category card, “Category activity” switch
    Access right
    Button "Delete Category"; without it, there is no trash button and no Delete key
    Prepare
    move the products you want to keep; check the counter in the card

    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