Classifications
Manage classification categories and product attributes.
Classification categories help organize products by applying consistent, reusable attribute structures across your catalog. These categories define classification mixins - standardized attribute schemas that are automatically applied to all products assigned to them.
Classification categories can create their own mixins and inherit mixins from parent classification categories. When a product is assigned to a classification category, it automatically receives all mixins from that category and its parent hierarchy, ensuring consistent, validated product data.
When creating a subcategory or assigning a parent category, both the parent and child categories must be of the same type - STANDARD or CLASSIFICATION. You cannot have a CLASSIFICATION category as a child of a STANDARD category, or the other way round.
You can switch to the classifications tree view to see the category hierarchy. You can sort and reorder classification categories using the arrows ↑↓ to move a category up or down. The position is recalculated based on the move. Reordering is possible only within the same level—for example, you can sort subcategories within the same parent, or reorder categories at the parent level.
Reordering has no effect when two categories share the same position value. Use unique position values for each category at the same level so that sorting works correctly.
Prerequisites
Before creating a classification category, ensure that you have:
A schema URL for each classification mixin you want to define. The schema defines the structure and validation rules for the mixin attributes.
A code for the classification category. This is mandatory and is used to construct unique mixin paths.
Multiple classification mixins
You can define multiple classification mixins for a single classification category. This allows you to group related attributes together and apply them to products assigned to that category.
For example, an "Electronics" classification category might have:
A
technicalSpecsmixin for technical specificationsA
warrantyInfomixin for warranty information
Both mixins would be automatically applied to products assigned to the Electronics category.
For technical details about classifications, see the Classification Tutorial in the Emporix API Reference.
Creating a classification category
Add classification mixins
Go to the Classification tab to add mixin schemas. You can either use the schema that is already created in the Management Dashboard, or upload a new one, not available in the system yet.
Choose Emporix mixin schema if you want to use a schema that is already available in the tenant. If it's not created yet, you can add it in Management Dashboard under Settings → Mixin Schemas. It must be of the Classification type.
Once the schema has been created, choose the Emporix mixin schema and select it from the drop-down list.
To learn how to create and manage mixin schemas in the Management Dashboard, see Mixin Schemas.
Choose My own mixins schema to create a custom schema by providing a schema URL. Use this option if the mixin schema you want to use for the classification category is not available in the Emporix system. Enter the schema details and add a URL with a valid schema JSON file.
If you want the mixin fields to be mandatory for products assigned to this classification category, set the Required toggle to active.
Optional: Choose a parent category and position
If the classification category you create should be a child category of a different one, you can define a path to the parent category in the Path tab.
The position indicates the order in which the classification category is displayed among its siblings in the classifications tree view. The position value is used when sorting categories - use unique values for each category at the same level so that reordering works correctly.
For example, you create a Corder Power Tools category, which is a child of the Power Tools one.
Set the classification category validity
If needed, choose the validity period for the schema in the Validity tab. This allows you to define when the classification category should be active.
The Published box indicates whether the classification category is available for use. When published, the classification category is active and visible in the product view for products assigned to that category.
Result: When the classification category is ready, it's visible in the Classifications view list. Products assigned to this category automatically inherit all classification mixins defined for it.
Assigning products to classification categories
When you assign a product to a classification category, it inherits the relevant classification mixins:
assigning a product to a parent classification category makes only the attributes defined at that parent level available
assigning a product to a child classification category makes the attributes defined in the child classification category available, along with all attributes inherited from its parent categories of
CLASSIFICATIONtype
By inheriting attributes from the entire category hierarchy, products maintain consistent data more easily across related categories.
The inherited mixin attributes are visible in a separate Classification tab within the product view.
Required mixin validation
If a classification mixin is marked as Required, products assigned to that category must include values for all required fields defined in the mixin schema. The system validates this when products are created or updated, ensuring data completeness.
If a product is missing required fields, you get a validation error indicating which required properties are missing.
Classification schema versions
Whenever you change a mixin schema for the classification category, the changes are displayed in the classification and you can review what is different. You can either keep the old classification version or apply the new one. The change is visible in product data only after the new version is applied.
Review the schema changes
When the schema applied to the classification category has changed, you can view the details of the changed fields. A version number appears next to the classification category name, and you can switch between the old and new version to compare the changes. Changed fields are highlighted accordingly - blue for new, yellow for the changed ones.
Decide on the classification category version
Choose whether to keep the old (current) classification category version or switch to the new version with the changes.
To keep the previous version with no changes applied, choose Keep Old Version.
To apply the new version and have the changed fields applied, choose Apply Version (number). The new or changed attributes are visible on the list.
Save your changes
If you decided to apply the new version, choose Save to keep your changes. The changes are applied to products that use this classification only after you save.
Result: The new or changed fields are automatically fetched and displayed in the product view.
If you have the classification mixin schema Saved in the Classification tab in the product view, you can still view the changes and decide if you want to apply them or keep the old version.
If the schema is not saved there, the Classification tab in the product view always takes the latest Classification category version automatically.
To learn more about Mixin Schemas, see Mixin Schemas in Management Dashboard guides.
If you're looking for code tutorials, see Classification Tutorial in the Emporix API Reference.
If you're looking for API reference? see Category Service in the Emporix API Reference.
Last updated
Was this helpful?