Product Categories
Complete guide to product categories in Omnium - hierarchical organization, multi-language support, automatic creation, and API usage.
Product categories in Omnium provide a hierarchical structure for organizing products. Categories support multi-language content, automatic creation from product data, and flexible enrichment options.
Key Concepts
Hierarchical Structure
Categories form a tree structure through parent-child relationships:
- Each category can have a parent category (
parentIdproperty) - Categories with no parent are root categories
- Unlimited nesting levels are supported
- The
rootCategoryIdtenant setting defines the primary catalog root
Multi-Language Support
Categories are language-specific. Each category has:
- A
categoryIdthat identifies it across languages (e.g.,electronics) - A composite
idcombining category and language (e.g.,electronics_en,electronics_no) - Language-specific
nameanddescriptionfields
This means a category like "Electronics" exists as separate documents for each language, sharing the same categoryId but with localized content.
Relationship with Products
Products connect to categories in two ways:
| Property | Type | Description |
|---|---|---|
categoryIds | List<string> | Simple list of category IDs assigned to the product |
productCategories | List<ProductCategory> | Enriched category objects with full details (name, description, etc.) |
The categoryIds property stores the raw assignments. When category enrichment is enabled, Omnium populates productCategories with complete category objects.
Feature Overview
| Feature | Description | Learn More |
|---|---|---|
| Configuration | Tenant settings for category behavior | Configuration |
| Category Model | Full property reference | Category Model |
| Category Tree | Hierarchy and tree operations | Category Tree |
| Automatic Categories | Create categories from brand/season data | Automatic Categories |
| Product Enrichment | Populate products with category data | Product Enrichment |
| Dynamic Categories | Categories based on saved searches | Dynamic Categories |
| API Reference | Endpoints for category management | API Reference |
Common Use Cases
Catalog Navigation
Build category menus and navigation trees using the category tree API.
Brand-Based Organization
Automatically create and maintain brand categories using the brand scheduled task.
Seasonal Collections
Create season categories automatically from product season data using the season scheduled task.
Dynamic Product Groups
Use saved searches to create categories like "New Arrivals" or "On Sale" without manual product assignment.
Quick Start
- Configure settings - Set up category-related tenant settings in Configuration
- Create categories - Use the API or Omnium UI to create your category structure
- Assign to products - Add category IDs to products via import or API
- Enable enrichment - Turn on product enrichment to populate category details on products