Category detail

Manage the category's definition, language and SEO content, products, product sorting, relation rules, and channel mappings.

The category detail page is where you manage all settings of a single category, including language and SEO content, linked products, product sorting, automatic product binding rules, and marketplace mappings in one place. The catalog team determines the category's storefront appearance and which products to display in what order from here. Use the Categories screen for structural changes in the category tree (adding, sibling order, deleting).

Accessing the screen

1. Open the PIM & Catalog › Catalog › Categories screen.
2. Click the relevant row in the category tree.

Category links in the Price threshold screen also open this page directly. The open tab is stored in the page address; refreshing the page or sharing the link opens the same tab. If you do not see Categories in the menu, your account does not have permission for this screen.

Screen sections

• Title: Category name; below it, full path and category code. The Back to categories link returns to the previous page.
• Title buttons: Category's publication badge (Published / Not published) and if you have write permission, the Edit button. In edit mode, these are replaced by Delete, Cancel, and Save.
• Tabs: Definition, Localized names, SEO, Generic attributes, Attribute sets, Products, Product sorting, Relation rules, Channel mappings, History. The Localized names, SEO, and Channel mappings tabs show record counts beside them.

Viewing and editing mode

The page opens in viewing mode. To change category settings, press the Edit button. Tabs are grouped by save behavior:

Unsaved changes: If you make changes in edit mode and press Cancel or try to leave the page, a Changes not saved dialog asks "Unsaved changes will be lost. Continue?". Discard changes deletes changes; Cancel keeps you on the page. Browser warns when closing the tab. Switching tabs does not discard your draft.

Validation before saving: If any of the following occur, Save is disabled and a red warning box above the Definition tab lists the issues:

• "Menu product count or price thresholds are outside the allowed range"
• "Value must be entered or language deleted for <language>"
• "Missing or invalid row in generic attributes"
• "Store and value must be entered together for H1"

If saving succeeds, a Saved notification appears and the page returns to viewing mode.

Definition tab

Viewing

In viewing mode, two cards are side by side. The left card lists identity and content fields (Record id, Category code, Tree, Parent category, Full path, language-dependent fields, Node type, Template, Default sorting, Sort for unsorted products, Order, Search box order). The right card lists storefront settings (Page size, Page size options, Price ranges, Menu visibility product count, Increase / decrease threshold, Redirect URL, Flag style, Image, Icon, Expiry date, Created, Updated).

• Language-dependent fields (Category, URL, Description, Details, Meta title, Meta description, Meta keywords) show one example value per row: first from the console language, if none then from the standard record, if none then the first found value. The language icon beside shows how many languages have values; clicking it opens a small Localized names panel listing values in all languages. If empty in all languages, it shows "—".
• Image and Icon show a small preview and filename; if preview cannot load, it shows "No preview". Clicking the preview opens the image in a new tab.
• If Expiry date is empty, it shows no end date.

Below are three more sections:

• Flags: Category flags are listed as badges. Blue badge means enabled, gray means disabled.
• Stores: Stores linked to the category. An orange badge indicates the store is Not defined on the parent category. If empty, it shows "Category is not linked to any store.".
• Other fields: If there are additional fields without a match above, they appear as a collapsible table (Field / Value).

Editing fields

Confirmation for changing default sorting

When changing Default sorting to ascending price, descending price, or default sorting type and pressing Save, a Rewrite the product order? dialog appears:

• In price sorting, product order in the category is rewritten by sale price. Products without price go to the end; equal prices keep current order.
• In default sorting, the default order list written by price is cleared.

Confirm with Save and reorder. The category is saved first, then the order is written; a notification shows "Order written for N products" or "Default order list cleared". If order cannot be written, a warning "Category saved but product order not written" appears; category settings remain saved.

Deleting the category

In edit mode, press the Delete button in the header. The Delete this category? dialog warns "<name> will be permanently deleted. This action cannot be undone." Confirm with Delete to delete the category; a Deleted notification appears and you return to the previous page; unsaved changes are not asked about. Deletion cannot be undone and does not warn about subcategories or linked products; check the category tree before deleting.

Localized names tab

Shows language-dependent content of the category. In viewing mode, table columns: Language, Category, Description, Details, Flag. The language-less base record is shown as Standard.

In edit mode, each language opens in a separate card:

• Category and Flag are text fields.
• Description and Details are rich text editors (formatting preserved).
• The Remove button at the top right deletes the language. The Standard record cannot be deleted.
• Use the Add language list below the cards to open a new card for a language not yet added.

If all fields of a non-standard language (including SEO meta fields in the SEO tab) are empty, the card shows a "Enter value or delete language" warning and saving is blocked.

The Localized names and SEO tabs are two sides of the same language records. Adding a language in one tab also opens its card in the other; deleting a language with Remove deletes its values in both tabs.

SEO tab

Language-based SEO fields

In viewing mode, table columns: Language, Meta title, URL, Meta keywords, Meta description, NoIndex. In edit mode, each language has fields for Meta title, URL, Meta keywords, Meta description, and a NoIndex checkbox. Adding and removing languages (Add language, Remove) works on the same records as the Localized names tab.

Below the tab in edit mode are sections for H1 headings, Fased SEO, and FAQ SEO. Changes here are saved with the header Save button.

H1 headings

The category page's H1 heading is defined per store. Viewing mode shows a Store / Value table. In edit mode, select Store and enter Value. Both must be entered together: if only one is filled, a warning appears "Store must be selected for H1 value." or "Store selected but H1 value missing." H1 does not appear in the Generic attributes tab and cannot be entered there.

Fased SEO

SEO records for filtered category pages (fased pages). Viewing mode columns: Name, Meta title, URL, Canonical URL, NoIndex, NoFollow, Sitemap, ALink, Created, Meta description, Description.

In edit mode, press Add to open a new row. Name max 250, Meta title, URL, and Canonical URL max 500 characters; Meta description is plain text, Description is rich text; NoIndex, NoFollow, Sitemap, and ALink are checkboxes. The Remove button deletes the row. The URL field of a fased record is used to link FAQ questions to that page; fased records with empty URL cannot be selected in FAQ.

FAQ SEO

Frequently asked questions are grouped by their linked fased page; each group header shows the question count. Questions without fased link are grouped under No fased link. Columns in the group: Order, Question, Answer.

In edit mode, press Add to open a new question; the Order field is prefilled with the next number. Select the fased page from the Fased list (if left empty, the question remains in the No fased link group), adjust the Order number, and enter Question and Answer in rich text editors. The Remove button deletes the question.

Generic attributes tab

Allows adding free key-value information per store to the category. Viewing mode columns: Store, Key, Value.

In edit mode, press Add to open a new row:

The Remove button deletes the row. If any row is invalid, saving is blocked. Changes are saved with the header Save button.

Attribute sets tab

Shows attribute sets linked to the category. Columns: Set, Source (This category or From parent), Record id.

In edit mode:

1. Select a set from the Add set list (only sets not yet added appear). The set is added immediately without confirmation and a Saved notification appears.
2. To remove a set, press the Remove (trash) button in the row. The Remove attribute set dialog says "<set> attribute set will be removed from this category." Confirm with Remove. A Deleted notification appears.

These actions save immediately; cannot be undone with Cancel. For more info on attribute sets, see Attribute sets.

Products tab

Lists products linked to the category; adding and removing products is done here. Actions in this tab do not require Edit; if you have write permission, action buttons appear.

Toolbar

Send to sorting, Add products, and Remove appear only for accounts with category write permission; without permission, row selection is disabled.

Columns

The filter icon in Type, Sale, Price, Product variety, and additional columns opens a value list. The list comes from products in this category with current search and filters applied; each value shows product count; empty values appear as (empty). Use the Search value box for long lists. Select values and press Apply; Clear removes the filter. Applying a filter resets to the first page.

Selection

Rows linked by Auto cannot be selected; these products cannot be removed manually and require changing the binding rule. When rows are selected, a banner above the table shows "N rows selected". Selection is preserved across pages. Selecting all selectable rows on a page offers "Select all N rows in query" to select all matching products (up to 20,000 rows; warning if exceeded). Clear selection removes selection. Changing search, filter, or Show SKUs resets selection.

Adding products by picking

1. Select Add products › Add by picking products. The Add products window opens.
2. Enter SKU, barcode, option code, or name in the Search box and press Filter or Enter. Column filters (Type, Product variety, Sale, Price, and additional columns) can be used here. Model and Customer code columns are hidden by default; enable via Columns. Shows 25, 50, or 100 rows per page.
3. To filter by value list, press Filter by list:
   • Select Field to filter: SKU, Barcode, Option code, Model code, or a custom attribute column.
   • Enter values in Values box (separated by line, comma, semicolon, or tab) or use Read from file to load the first column of a .xlsx, .csv, or .txt file. A counter below shows "N values".
   • Press Filter. Values are searched for exact matches in the selected field. Maximum 1000 values; above that, counter turns red and Filter is disabled. Clear removes the list filter.
4. Mark products to add (selection preserved across pages) and press Add selected (N).

A Saved notification appears, the window closes, and Products and Product sorting lists refresh.

If Field to filter is SKU, a Add by SKU list button appears below the list; this adds SKUs directly without selecting in the grid. Depending on your setup, Field to filter may open as an attribute column; to see the button, set the field to SKU. This method accepts up to 100,000 SKUs.

Total record count in filtered searches is approximate; if the last page is empty, go back one page.

The Add all products button below adds all products in the installation manually to this category. Confirmation Add ALL products in the installation? is requested and confirmed with Add all; the operation takes long and to undo, products must be removed individually or by list.

Adding and removing by SKU list

1. Select Add products › Add by SKU list (Excel / paste) or Remove › Remove by SKU list (Excel / paste).
2. Paste SKUs one per line in the Paste box (Excel copied columns are tab-separated; only the first column is read) or upload a file with Choose file (.xlsx, .csv, .txt). Uploading closes the paste box; to cancel the file, press Clear next to the filename.
3. A counter below shows "N records read"; duplicate SKUs count once. Maximum 100,000 SKUs accepted.
4. Press Add or Remove to start the operation.

The list is previewed first; writing occurs only when you press this button and no further confirmation is asked. The first row is also read as a value; remove header rows from your file. Rule-based (Auto) products are not removed by list. Notifications appear: Saved for adding, "Products removed from category" for removing.

Removing selected products

1. Select products to remove.
2. Choose Remove › Remove from category (N).
3. Confirm with Remove in the Remove products from the category? dialog.

This deletes the manual link of selected products to the category; for more than 1000 products, the operation may take long. A "Products removed from category" notification appears.

Sending to sorting

Used to add products to the manual sorting list without re-adding them to the category.

1. Select products and press Send to sorting.
2. Confirm with Send to sorting in the dialog.
3. A "Products added to sorting list" notification appears and the Product sorting tab opens.

Up to 1000 products can be added at once; if more are selected, a warning appears and the operation does not start.

Product sorting tab

Manage the manually defined order of products in the storefront for the category. A note above reminds that sorting is valid only when the category's sorting type is "Position Order"; it also shows the current sorting type.

Toolbar

• Sorted / Whole category: Shows only sorted products or first sorted then unsorted products. In Whole category view, unsorted rows show an unsorted badge and a note above shows the count of sorted products.
• Search (applies on Enter), Per page (25, 50, 100, 250).
• Appearance: Table or Image (card view).
• Clear filters (N), Retry, Columns (table view only), Full screen / Exit full screen.
• Export: Export all (Excel) (first 20,000 rows) or Export visible page (CSV). CSV includes a Variants column.
• If you have write permission: Import sorting, Add to sorting, and Delete menus.

Table columns

Handle, Move to position, Actions columns and row selection appear only for accounts with category write permission. Selection works like in the Products tab: selecting all rows on a page offers "Select all N rows in query"; selection resets on mode, search, or filter change.

Right-clicking a row opens the Row actions menu: Move to top, an order input box (enter new order number ≥1 and confirm), and Move to bottom.

In Image view, each card shows order number, stock badge (green if in stock, red if not), image, SKU, name, and price. Cards can be dragged or reordered with Move to top / Move to bottom buttons. Right-click menu works here too. Selection is only in table view.

Each move is saved immediately and a Saved notification appears.

Importing sorting

1. Press Import sorting.
2. Paste or upload a file (.xlsx, .csv, .txt). The first column must be order number, second column SKU. Excel files skip the first row as header; pasted text and CSV/text files do not skip the first row. Columns can be tab, semicolon, or comma separated.
3. Rows with non-numeric order or empty SKU are skipped. A counter below shows valid rows read. Maximum 400 rows accepted; above that, counter shows "N records read — maximum 400" warning and confirm button is disabled.
4. Confirm with Import sorting. A Saved notification appears.

Adding products to sorting

• Add to sorting › Add by picking products: Opens Add products to sorting window; search, column filters, and Filter by list work as in Add products window. Selected products are added to the end of the sorting list, not linked to the category. No Add all products or Add by SKU list here; max 1000 products can be selected, warning and disable if exceeded.
• Add to sorting › Add by SKU list: Paste SKUs or upload file. First column read as SKU; Excel skips first row as header. Max 1000 SKUs; apply with Add.

Both methods show a Saved notification on success.

Deleting from sorting

The Delete menu has three options; each opens a confirmation dialog and confirmed with Delete; products are not removed from the category:

A "Sorting updated" notification appears after the operation.

Relation rules tab

Shows rule groups that automatically bind products to the category based on attribute values. Columns: Rule group (group record number) and Conditions (each condition is a line in "attribute operator value" format; if attribute or value is missing, * appears). Products linked by rules appear as Auto in the Products tab.

In edit mode, Add rule button and Edit / Delete buttons appear per row. In Add rule or Edit rule dialog:

1. Select Rule type:
   • All products: All products in the installation are linked to this category; no conditions.
   • Rule based: Products matching conditions (equal / not equal) are linked.
   • Exceptions: Products matching conditions are excluded from the category.
2. For Rule based and Exceptions, press Add condition to add rows; select Attribute, Operator, and Value. The Operator list shows only operators valid for the selected rule type. The Value list appears when attribute is selected, showing values with product counts ("value (N products)"); if no attribute selected, it shows "Select attribute first". Conditions can be removed with Remove.
3. Press Save. For Rule based and Exceptions, Save is disabled if no conditions or attribute is missing. For All products, Save is immediately enabled.

Changing rule type keeps only conditions valid for that type; others are discarded. After saving, a Saved notification appears. Deletion asks Delete this rule? confirmation and shows Deleted notification. Adding, editing, and deleting save immediately; header Cancel does not undo.

The All products rule links all products in the installation immediately upon pressing Save without further confirmation. Use with caution.

Channel mappings tab

Shows corresponding categories of this category in marketplaces and sales channels. Columns: Channel, Channel category, Channel category id. If none, shows "Category is not mapped to any marketplace category.".

In edit mode:

1. Press Add mapping (disabled if no channels defined). The Pick a channel category dialog opens.
2. Select a channel from the Channel list; until selection, it shows "Select a channel first". Use Search to find channel categories by name or code; matches are bolded.
3. Click the row of the channel category to map. The mapping is saved immediately without confirmation, a Saved notification appears, and the dialog closes. Use the arrow in the row to expand subcategories; clicking the row selects it.

To change an existing mapping, press Edit in the row; the dialog opens with the same channel's tree without channel selection, and clicking a new category replaces the mapping. The Delete button removes the mapping after Delete the mapping? confirmation with explanation "The category's counterpart in this channel will be removed." These actions save immediately; header Cancel does not undo.

History tab

Lists records of operations performed on the category from newest to oldest. Columns: Date, Operation, User, Payload. The Payload column shows Request and Response contents as expandable sections.

The search box above the table ("Search in type, user, or request/response") searches operation type, user, and request/response content; you can filter by All types and All users lists. These lists contain options from the category's own records. Filtering applies immediately and a "N / M records" counter appears on the right. If no records exist, it shows "No records found".

Common issues

• Save button disabled. There is a validation error in the draft. Switch to the Definition tab; a red box above lists issues. Delete empty language cards, fill store and key in Generic attributes, or enter store and value together for H1.
• Some rows in Products tab cannot be selected. These products are linked Auto by a relation rule. To remove from category, edit the rule in Relation rules tab or add an Exceptions rule.
• Changed sorting but storefront did not update. Manual sorting is valid only when Default sorting is set to "Position Order". Check sorting type in Definition tab.
• Cannot change parent category. Parent category is read-only here and cannot be changed in the category tree screen either.
• Made wrong channel mapping. Press Edit and select the correct channel category or remove the mapping with Delete in the Channel mappings tab.
• Cannot see action buttons in Products or Product sorting tabs. These buttons require category write permission; without it, you can only view and export lists.
• "PIM service not configured." or "Something went wrong" messages appear. The first means product information management connection is not defined in the installation; contact your system administrator. For the second, press Retry; if problem persists, notify your system administrator.

Related screens

• Categories
• Products
• Attribute sets
• Category templates
• Price threshold

Video tutorials

• Binding products to category: Search and select products in the Products tab of category detail, add by SKU list or Excel; add, remove, and export products; step-by-step guide and video.
• Binding products by rule to category: Create rules in Relation rules tab to automatically bind products by attribute (e.g., material, color); continuous rule operation and relation with manual additions; step-by-step guide and video.
• Sorting products in category: Add products to sorting list in Product sorting tab, drag and drop or move by order number, import sorted list; relation with default sorting; step-by-step guide and video.
• Editing category info and SEO fields: Find category in tree; edit name, description, meta title and description, and URL; learn difference between menu and tree; step-by-step guide and video.