A product category groups products in the product register and helps you find them. Every product must have a category. A category is not a stock balance, a spare part linked to a Spot, or product consumption recorded on a task.
Requirements and permissions
Product categories are managed in the browser. The warehouse feature must be enabled for your service. In the main menu, open Manage warehouses → Products, then select Product settings → Product categories in the page navigation.
Viewing, creating, editing and deleting categories each require the corresponding permissions. Permission to create or edit products gives you permission to view categories, but does not give you permission to manage them. A local administrator can manage categories and help arrange the necessary permissions. Moving a product to another category requires permission to edit the product.
Create a product category
- Select Create new product category above the category list.
- Enter a Name. This is required, must not exceed 256 characters, and must not match the name of an existing category.
- Optionally, add a Description explaining which types of products belong in the group.
- Save using the Create new product category button on the form.
Creating a new category does not create products or add goods to stock. Check that the category appears in the list, then open it by clicking its name to check the saved details. If it does not appear, clear the list's column filters.
You can also create a category on a product form. On the same Products page, select the Products view. Open an existing product by clicking its name or the pencil icon on its row, or start creating a new product using the Create new product button above the table. On the form's Basic info tab, there is a Create new product category button next to the Product category selection.
Once created, the new category is added to the selection list and selected for the product. Check the selection and save the product separately. The category is saved using its own create button: cancelling the product form does not delete it. See also creating a product.
Edit the shared name or description
In the category list, click the category's name or the pencil icon on its row. Change the Name or Description and select Save on the form. The name's requirements for uniqueness, maximum length and a non-empty value also apply when editing. With view permission only, you can view the details but cannot save changes.
You can also edit the name or description by double-clicking the corresponding cell in the list. The cell change is submitted for saving when you finish editing the cell. If saving returns an error, correct the information and reopen the category to check the saved value.
Changing the name renames the same shared category. All products belonging to it remain in the same group, and the group appears under its new name when the product data is fetched again. The change does not move products to another category or record a stock transaction.
The category name link in the Product category column of the Products table also opens this shared category for editing. Any change to the name or description made there applies to the entire category. The link does not change the category selected for that product.
Move a product to another category
On the Products page, select the Products view and open the product by clicking its name or the pencil icon on its row. In the Product category field on the product's Basic info tab, select another existing category and click Save on the product form. The field cannot be left empty.
This changes the group to which this product belongs. It does not move goods between warehouses, change stock balances, or create new consumption or a stock transaction.
The category filter in the Product usage and Product Costs reports uses the product's current category even for data from earlier periods. After a change, the product's old transactions and cost rows may therefore be excluded when filtering by the old category and included when filtering by the new category. This changes which rows are included in the report; changing the category does not alter the quantities in old transactions or the saved amounts in cost rows. Report periods, data selections and calculations are explained in product usage and costs on report pages.
Reopen the product and verify the selection. Also check the product counts for the old and new categories in the refreshed category list. If you use a report filtered by category, fetch its data again using the same period and other filters. For more information on finding a product, see finding products and viewing product details.
What does Product count mean?
Product count in the category list shows how many records in the product register refer to the category. It is the current number of records, with no date range filter, rather than the number of units in stock or products used. For example, two different products in the same category give a count of 2, regardless of their stock balances.
The count also includes inactive products and product records marked as deleted if they still refer to the category. However, products marked as deleted are excluded from normal product searches and from the product check that prevents category deletion. The displayed count alone therefore does not determine whether a category can be deleted.
You can filter the list using the column filters, for example by name, description or product count. Export view to Excel above the list exports the category table data to Excel.
Delete an unnecessary category
A category cannot be deleted if it contains products that have not been marked as deleted. A product with Product in use unchecked also prevents the category from being deleted. Making a product inactive keeps it in its category; it does not mark the product as deleted.
First move any products you want to keep to another category and save each change. Check inactive products as well. You do not need to delete products just to delete a category.
Then click the trash icon on the relevant row in the Product categories list and confirm by selecting Yes. No cancels the deletion. A successful deletion removes the category itself and does not move or delete its products. If deletion is blocked, the category remains; check the products belonging to it and your permissions.
Verify the deletion by reopening the category list and checking that the category no longer appears with all filters cleared. A deleted category can no longer be selected for a product.
Categories in imports and mobile apps
Create the required categories before importing products. An import that uses a category name looks for an existing category with that name and does not create a missing category. Check the names after renaming a category as well: import data using the old name must be corrected. If both a name and an identifier are supplied in the import, a non-empty name determines the category selection; the identifier is used only when the name is missing. See importing, exporting and bulk updating products.
The Category field on the product creation form in Android and iOS uses categories already created in the service. Use the browser to manage categories as described in this guide. Opening the product creation form in the mobile apps is explained in creating a product.
On the iOS creation form, the category menu opens only when more than one category has been fetched. A single category is not selected automatically. If the category selection does not open when there is only one category, create the product in the browser.