Skip to content
P4 Software P4 Software / logisticaHQ-en

Add these docs to Claude

Ask Claude questions about these docs. Claude reads the published pages and links you back to them. Copy this address:

https://p4-software.opendocs.page/mcp

In claude.ai or Claude Desktop: open Settings, then Connectors, choose Add custom connector and paste the address.

In Claude Code, run:

claude mcp add --transport http docs https://p4-software.opendocs.page/mcp

Product categories

Product categories
← Back to Setup

LogisticaHQ release 2.56.19

What these screens are for

Product categories organise your catalogue. A category groups Products, for example "Cabinetry". A subcategory divides a category, for example "Hinges" inside "Cabinetry". Every product can carry one category and one subcategory.

This guide covers two screens:

  • The Product categories list. See how your catalogue is organised, how many Products each category has, and delete categories.
  • The Product category page. Edit one category and manage its subcategories.

You find them under Setup › Products › Product categories.

The Product categories list

An important rule: Products keep the category's name

A product stores the name of its category and subcategory. It does not store a link. Two things follow, and both appear in this guide:

  • Renaming a category or a subcategory updates every product that carries it. The change is made in the same step, so no product is left with the old name.
  • A category or subcategory that Products still use cannot be deleted. You must first move those Products to another category or subcategory.

Names are compared without regard to capital letters or extra spaces. "Cabinetry" and " cabinetry" count as the same category.

The Product categories list

Header

Part What it does
Caption Setup › Products, title Product categories Where you are. The subtitle says "How your catalogue is organised: categories and their subcategories".
Refresh (arrows icon) Reads the categories and the product counts again. If a preview is open, it follows the reload. It closes if its category no longer exists.
New category Opens a blank category page. Shown only to Users who may enter data.

The summary strip

Under the header, a strip gives you the totals. The three figures:

Figure What it shows Note under it
Categories How many categories you have. "every category has subcategories", or "{n} with no subcategories".
Subcategories The total number of subcategories. "about {n} per category".
Products The total number of Products in the catalogue. "every product has a category" (green), or "{n} Products have no category" (amber).

The Products figure shows a dash until the counts are known.

Where your Products are

Next to the figures there is a bar that shows where your Products are. It appears once the counts are known, and only if your catalogue has at least one product.

  • The bar has up to five colored segments, one for each of the five categories with the most Products. Each segment is as wide as that category's share of all Products.
  • A grey segment holds everything else. It is named "{n} others" or "1 other". It also holds Products that carry no category. When the grey segment holds exactly the Products that have no category and nothing else, it is named No category.
  • The segments always add up to all your Products.
  • The title shows the share of the top categories, for example "top 5 = 78%".
  • A legend under the bar names each segment with its number of Products.

The summary strip with the "Where your products are" bar

Quick filters and Sort

In the toolbar there are three quick filters. Each shows how many categories it holds. A click on a filter narrows the list at once.

Filter Shows
All Every category.
No subcategories Categories that have no subcategory. Use it to find categories to complete.
No description Categories whose description is empty.

The Sort list has two choices:

Choice Order
Most Products The category with the most Products first. This is the default.
Name A-Z By name.

You can also click a column header to sort the list another way.

The toolbar also has Search, Filters, Columns, Export and AI Assist. The search box reads "Search a category or subcategory". It finds a category by its own name or by the name of any of its subcategories. Export writes the subcategories of each category in one column.

The list reads all categories at once. Searching, filtering and sorting then happen on your screen.

Columns

Three columns are shown by default. The Description column is hidden, because the description already appears under the name. You can show it under Columns.

If you already saved your own layout. A user who saved a column layout before this release keeps the old columns. For example, a saved layout that shows Description keeps showing it. To get the new layout, open Columns and use Reset.

Column What it shows
Category A colored tile with the category's initials. The color depends on the name, so a category keeps its color whatever the sort or filter. Next to it, the name as a link to the category page. Under the name, the description, or "Add a description" in italics if there is none.
Description The description on its own. Hidden by default.
Subcategories The first three subcategories as tags, then "+{n} more". A category with none says "No subcategories yet" in amber. This column cannot be sorted or filtered, but the search box reaches its names.
Products A bar against the category with the most Products, the number of Products, and the share of all Products, for example "22%". A share under 1% shows one decimal ("0.3%"), and under a tenth of a percent it shows "<0.1%", so a category that is not empty never reads "0%". A dash shows when the counts cannot be read.

The preview drawer

Click a row to open a drawer beside the list. The drawer shows:

Part What it shows
Header The tile, the name and the description. The X closes the drawer.
Products How many Products carry the category.
Subcategories How many subcategories it has.
Share Its share of all Products.
Open Opens the category page.
View Products Opens the product list, searched for the category's name. This is a text search, not an exact filter. A product whose SKU or description contains the name is shown too, so the button does not promise "these N Products".
Biggest subcategories The six subcategories with the most Products, as bars with their counts. If there are more, one line sums them up, for example "+ 12 more with 1-63 Products each". A subcategory that no product carries counts 0.

If the category has no subcategory, the drawer says "No subcategories yet". While the counts load it says "Loading...". If the counts cannot be read, the names are shown with a dash.

The subcategory counts are read when you open the drawer, only for that category. This matters because the same subcategory name can exist under several categories ("Accessories" sits under many).

The preview drawer of a category

The action dock and Delete

Tick one or more categories to raise the dark action bar at the bottom.

The bar shows how many are ticked, for example "2 selected". Its note lists the names of the first three ticked categories, then "+{n} more". If Products still use any ticked category, the note adds in amber how many: "1 product still uses them" or "{n} Products still use them". You know this before you press anything.

The buttons:

Button What it does
Delete... Deletes the ticked categories. Shown only to Users who may enter data.
X Clears the selection.

What Delete does

  1. If Products still use any ticked category, nothing is deleted and nothing is sent. A window explains: "{n} Products still use the selected categories. A category can be deleted only once no product uses it: move those Products to another category first, then delete." The server works the same way: it refuses the whole batch if even one category is still on a product.
  2. If no product uses the ticked categories, a red window asks "Delete product category {name}?" (or "Delete {n} product categories?"). Confirm to delete them. The list reloads and the drawer closes if its category was deleted.

Good to know:

  • The counts are read when the page opens or when you press Refresh. If someone moved Products a moment ago, the count can be old. The server stays the guard: if it refuses, its message is shown.
  • To empty a category, change the Category of its Products (on each product's page). Then delete the category.

The Product category page

Click a category name, or Open in the drawer, to open it. New category opens the same page with nothing filled in. The link Product categories at the top takes you back to the list.

The Product category page

Header card

Part What it shows
Tile and title The tile with the initials, the caption "Product category", the name, and the description. The title is the saved name. A name you are still typing does not retitle the page. A new category reads "New category".
Products How many Products carry the category.
Subcategories How many saved subcategories it has.
Share of catalogue Its share of all Products.
Refresh (arrows icon) Reads the category again.
Changes... Opens the history of changes. Not shown for a new category.
View {n} Products Opens the product list searched for the category's name. It reads "View 1 product" for one product, and "View Products" while the count is unknown. Not shown for a new category.

Details card

Field Rule
Name Required. A blank name is refused by the server: "Category name is required".
Description Optional.

Under the boxes, for a saved category, a note warns you: "Renaming this category also updates all {n} Products assigned to it." It uses the real number of Products, and says "the 1 product" for one. While the count is unknown it shows the general sentence "Renaming this category also updates every product assigned to it." It is left out when no product carries the category.

Users who may not enter data see the boxes as read-only.

Subcategories card

The title row has Add subcategory. It is shown only to Users who may enter data, and only for a category that was already saved. A new category says "Save the category before adding subcategories."

The table shows each subcategory with:

Column What it shows
Name The name. Editable.
Description The description. Editable.
Products A bar and the number of Products of this category that carry the subcategory. A new row says "New: save it to start using it".

The rows are sorted by number of Products, the biggest first, and by name when equal. A note under the table says: "Sorted by Products. Renaming a subcategory also updates its Products. A subcategory still used by Products cannot be deleted until those Products are moved."

An empty category says "No subcategories. Products in this category will have no subcategory to choose."

Each subcategory row saves by itself. Nothing is sent as you type.

  • Add subcategory puts a new blank row at the top, highlighted in blue, with the cursor in its name.
  • When you change a saved row, it turns amber. Its Save button appears.
  • A new row has Save and Discard new subcategory (a cross). Discard drops the row. Nothing was sent to the server.
  • Save posts that one row and reads the category again. The order and the counts are refreshed.
  • A blank name is refused against the row: "Name is required".
  • Delete (the trash icon) is shown for saved rows only.

Renaming a subcategory updates the Products of this category that carry it, in the same step.

Deleting a subcategory

  • If Products of this category still carry it, nothing is deleted. A window says "{n} Products in this category still use subcategory {name}. A subcategory can be deleted only once no product uses it: move those Products to another subcategory first, then delete."
  • If no product carries it, a red window asks "Delete subcategory {name}?". After you confirm, the subcategory is deleted and the page reads the category again.

Users who may not enter data cannot edit any box or see Add, Save or Delete.

The Subcategories card with a new, unsaved row at the top

Saving the category: the save bar

A dark save bar rises at the bottom only while Name or Description differ from what was loaded. It says "1 unsaved change" or "{n} unsaved changes" and names the changed fields. The buttons:

Button What it does
Update Saves the name and description, then reads the category again. If you renamed it, the page then shows the effect on the Products.
Discard Puts the Name and Description back to the saved values.

Good to know:

  • Subcategory rows never raise the save bar. They save on their own, row by row.
  • The boxes are locked while Update runs.
  • If the server refuses, the bar stays and your typing stays. Fix it and press Update again.
  • Updating a new category creates it. The page then works as a saved category, and you can add subcategories at once.
  • Users who may not enter data never see the save bar.

Quick Reference: what is allowed

You want to... Allowed when
Rename a category Always, for Users who may enter data. All its Products take the new name.
Delete a category No product uses it.
Delete several categories No product uses any of them.
Rename a subcategory Always, for Users who may enter data. Products of that category take the new name.
Delete a subcategory No product of its category uses it.
Add a subcategory The category was saved first.

Was this page helpful?