> For the complete documentation index, see [llms.txt](https://developer.emporix.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.emporix.io/release-notes/archive/2022/2022-04-07-ce-catalog-and-category.md).

# 2022-04-07: CE - Catalog and Category

### Overview

To meet the complexity and scale of B2B Commerce needs, we have redesigned our implementation of how products are stored, categorized and managed in the Emporix platform.

### New features

#### Catalog Service

We have introduced a new feature called Catalog, which acts as a container for Categories and Products. A Catalog acts as a “root node” of a collection of Categories.

| **Features**                     | Benefits                                                                                                                                                                                                                                                                                                                                               |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Multiple Catalogs per Tenant** | <p>A tenant can create and manage multiple catalogs for different purposes. For example:</p><ul><li>Supplier and Seller Catalogs</li><li>One Catalog per Product Line or Division</li><li>Seasonal Catalogs</li></ul>                                                                                                                                  |
| **Multiple Catalogs per Site**   | More than one Catalog can be published on a site at the same time. For example: Product Catalog and Promotional Seasonal Catalog.                                                                                                                                                                                                                      |
| **Catalog Visibility**           | Catalogs have a flag to set whether they are visible in the storefront or not, and additionally have a visibility date range that can automatically control the dates they should be visible from and to. For example: Promotional or Seasonal Catalog can be automatically made visible and expired from the storefront based on pre-set date ranges. |
| **Multi-language Support**       | Category attributes (such as name and description) support language Localization.                                                                                                                                                                                                                                                                      |

#### Category Service

We have also completely redesigned our Category Service implementation to support a much more flexible structure. Categories can be nested and once created can be easily moved around to restructure the collection the best way for your business.

| **Features**                         | Benefits                                                                                                                                                                                                                                                                                                                                     |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Category supports multiple views** | Category structures can be viewed either as a flat list or as a hierarchical structure to better see the parent/child relationships for easier browsing and understanding.                                                                                                                                                                   |
| **Category Visibility**              | Categories have a flag to set whether they are visible in the storefront or not, and additionally have a visibility date range that can automatically control the dates they should be visible from and to. For example: Specific Categories can be automatically made visible and expired from the storefront based on pre-set date ranges. |
| **Multi-language Support**           | Catalog attributes (such as name and description) support language Localization.                                                                                                                                                                                                                                                             |
| **Category Assignment**              | Categories can be assigned to one, and only one Catalog.                                                                                                                                                                                                                                                                                     |
| **Product Assignment**               | Products can be assigned to one or more Categories.                                                                                                                                                                                                                                                                                          |

Both Catalogs and Categories work with our existing Product Service to provide greater flexibility and scalability in how our customers manage the goods that they sell through their digital commerce channels.

### Fixes and improvements

None as these are new services.

### Known problems

No Known Problems at time of release.

### Documentation and links

* User Guides:
  * [Catalogs](/ce/core-commerce/catalog.md)
  * [Categories](/ce/core-commerce/categories.md)
* API Reference:
  * [Catalog Service](/api-references/api-guides/catalogs-and-categories/catalog.md)
  * [Category Service](/api-references/api-guides/catalogs-and-categories/category-tree.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.emporix.io/release-notes/archive/2022/2022-04-07-ce-catalog-and-category.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
