Products

Categories

Categories group the catalogue so products can be filtered, found and reported on by type.

Last updated 2026-10-13

DigitalKey ERP — Docs · digital-key.co/docs/products/categories

Overview

A category is a simple label attached to a product. Categories drive the filter on the product list, the grouping in the POS, and the breakdown in stock reports. A product can belong to at most one.

Products — Category management
Category management
Category management — The list of categories with their product counts and the controls to add or deactivate one.
  1. 1

    Open category management

    Go to Products and open the categories panel.

  2. 2

    Add a category

    Enter a name and save. It becomes available on the product form immediately.

  3. 3

    Assign products

    Set the category on each product, either while adding it or by editing an existing one.

Fields

POST /api/v1/products/categories
ParameterTypeRequiredDescription
namestringRequiredCategory name, as shown in filters and on the product form.
parent_idintegerOptionalParent category, for a nested structure. Optional.
Sub-categoriesWhen adding or editing a category you can pick a parent, which makes it a sub-category shown under that parent. A category cannot be its own parent, nor the child of one of its own sub-categories.

Adding, renaming, switching off and deleting categories needs Categories & units in the permission matrix.

Organising the catalogue

Categories are most useful when they match how staff actually look for things at the counter, not how a supplier catalogue is arranged. A few practical rules:

  • Keep the list short enough to scan — a dozen categories beats fifty.
  • Name them the way staff speak, so the right one is obvious under pressure.
  • Split a category only when it has grown big enough to be slow to search.

Deactivating a category

WarningDeactivating a category does not delete it and does not touch the products in it. Those products keep their category_id and stay sellable; the category simply stops being offered on the product form and in filters. Reactivating it restores the grouping exactly as it was.

Deleting a category

ImportantDeleting goes further than switching off: the products in the category become uncategorised and its sub-categories are removed with it. The products themselves are not touched. A deleted category can be restored by the owner from the recycle bin.

Related

  • Adding Products — assigning the category.
  • Units — the other product-level lookup list.
  • Reports — stock and sales broken down by category.