Skip to main content

Category Management

Quark Commerce uses a dual category system: Master Categories for internal organization and Sales Categories for storefront navigation.

Master Categories​

Master categories are the internal product taxonomy used for organizing products during management. They are not directly visible to customers.

Structure​

  • Hierarchical (parent → children)
  • Every product must belong to exactly one master category
  • Example: Apparel → Tops, Bottoms, Dresses, Outerwear, Accessories

Managing Master Categories​

  1. Navigate to Catalog → Categories
  2. Select the Master tab
  3. Create, edit, reorder, or delete categories
  4. Set parent-child relationships via the parent dropdown

Sales Categories​

Sales categories are the storefront-facing browsing taxonomy. These are what customers see in the navigation and category pages.

Types​

TypePurposeExample
TaxonomyHierarchical browsing structureShop All → Tops, Bottoms, Dresses
PromotionalCross-cutting collectionsNew Arrivals, Sale, Best Sellers

Managing Sales Categories​

  1. Navigate to Catalog → Categories
  2. Select the Sales tab
  3. Create categories with a type (Taxonomy or Promotional)
  4. Set slugs for SEO-friendly URLs
  5. Assign products via the product edit form

Localization​

Category names and descriptions can be translated:

  1. Open a category for editing
  2. Switch the language selector to the target language
  3. Enter the translated name and description
  4. Save — translations are stored in the localization system

Slugs​

Sales categories have SEO-friendly slugs (e.g., s-tops, s-new-arrivals). Slugs are:

  • Unique across all entities
  • Language-specific
  • Used in storefront URLs
tip

The naming convention s- prefix for sales category slugs is just a convention from the seeder data. You can use any unique slug format.