2025-12-17: Category Service - classification categories

Overview

The Category Service now supports classification categories, allowing you to define categories with specific classification mixins that can be inherited by subcategories. This enables better product classification and attribute management throughout your category hierarchy.

Categories can now be designated as either STANDARD (default) or CLASSIFICATION types. Classification categories can define their own classification mixins, which are then inherited and combined with parent classification mixins in the category.

What's new

Category types

A new type field has been added to the category model with the following values:

STANDARD - Regular category (default behavior)
CLASSIFICATION - Category that can define classification mixins for product classification. The category of type CLASSIFICATION must have category code defined.

Classification mixins

Classification categories support two new fields:

Field

Description

ownClassificationMixins

Classification mixins defined specifically for this category. Each mixin includes name, schemaUrl, and an optional required flag.

classificationMixins

Read-only field in responses containing the combined list of classification mixins inherited from parent categories plus the category's own mixins. Includes sourceCategoryId to identify the origin category.

Schema structure

OwnClassificationMixin:

name - Name of the mixin (pattern: ^[a-zA-Z0-9_]\S*$)
schemaUrl - URL of the mixin schema (pattern: ^https?://[^\s/$.?#].\S*$)
required - Boolean indicating if the mixin is required

ClassificationMixin (response only):

Includes all fields from OwnClassificationMixin
sourceCategoryId - ID of the category where the mixin is defined
mixinPath - The mixins path that should be used when defining attributes on a product. It's built based on the following pattern: class_<sourceCategory.code>_<name>.