Skip to content

Commit

Permalink
Merge remote-tracking branch 'docs/master' into patch-6
Browse files Browse the repository at this point in the history
  • Loading branch information
lenadoc committed Jan 23, 2024
2 parents 0984864 + b44fef9 commit b0fcf1a
Show file tree
Hide file tree
Showing 30 changed files with 2,329 additions and 9 deletions.
4 changes: 4 additions & 0 deletions _data/sidebars/scos_dev_sidebar.yml
Original file line number Diff line number Diff line change
Expand Up @@ -1737,6 +1737,8 @@ entries:
nested:
- title: "Autocomplete"
url: /docs/scos/dev/front-end-development/marketplace/table-design/table-column-type-extension/table-column-type-autocomplete.html
- title: "Button Action"
url: /docs/scos/dev/front-end-development/marketplace/table-design/table-column-type-extension/table-column-type-button-action.html
- title: "Chip"
url: /docs/scos/dev/front-end-development/marketplace/table-design/table-column-type-extension/table-column-type-chip.html
- title: "Date"
Expand Down Expand Up @@ -1799,6 +1801,8 @@ entries:
nested:
- title: "Close Drawer"
url: /docs/scos/dev/front-end-development/marketplace/ui-components-library/actions/actions-close-drawer.html
- title: "Confirmation"
url: /docs/scos/dev/front-end-development/marketplace/ui-components-library/actions/actions-confirmation.html
- title: "Drawer"
url: /docs/scos/dev/front-end-development/marketplace/ui-components-library/actions/actions-drawer.html
- title: "HTTP"
Expand Down

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
@@ -0,0 +1,92 @@
---
title: Category Management feature overview
description: The feature lets you keep your product catalog organized and comprehensible for the customers who can easily navigate the storefront and search products quicker
last_updated: Dec 06, 2023
template: concept-topic-template
originalLink: https://documentation.spryker.com/2021080/docs/category-management-feature-overview
originalArticleId: 33b65d5e-fd6c-4017-92ed-7229883beeb0
redirect_from:
- /2021080/docs/category-management-feature-overview
- /2021080/docs/en/category-management-feature-overview
- /docs/category-management-feature-overview
- /docs/en/category-management-feature-overview
- /docs/scos/user/features/202200.0/category-management-feature-overview.html
- /docs/scos/user/features/202311.0/category-management-feature-overview.html
- /docs/scos/dev/feature-walkthroughs/202200.0/category-management-feature-walkthrough.html
- /docs/scos/dev/feature-walkthroughs/202311.0/category-management-feature-walkthrough.html
- /docs/pbc/all/product-information-management/202311.0/feature-overviews/category-management-feature-overview.html
---

A category is a set of products that share a common attribute and, therefore, can be united logically. The *Category Management* feature lets Back Office users structure products into a logical system where each product belongs to a category or set of interrelated categories. You can [assign categories to all or individual stores](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/manage-in-the-back-office/categories/assign-products-to-categories.html) from the Back Office or [import stores for categories](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/import-and-export-data/categories-data-import/import-file-details-category-store.csv.html). For details about how a Back Office user can group products under categories, see [Assigning products to categories](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/manage-in-the-back-office/categories/assign-products-to-categories.html).

## Root, parent, and child categories

The product catalog is structured in a category tree, which consists of root, parent, and child categories.

A *root category* is a base category that stands on top of the category hierarchy. Product and child categories are assigned to root categories, but root categories can not be assigned to anything. Also, a store can only be linked to one root category tree, while a root category tree can be linked to multiple stores. Root categories are added through [data import](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/import-and-export-data/categories-data-import/import-file-details-category.csv.html) and cannot be created in the Back Office, unlike other categories, which can be added in both ways.

A parent category is a category that has products and other categories assigned to it. Categories assigned to parent categories are referred to as *child categories*. Products belonging to a child category that is assigned to a parent one belong to the parent category too. You can assign child categories to parent ones by editing categories in the Back Office or importing the categories. For information about how to assign child categories to parent categories, see [Create categories](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/manage-in-the-back-office/categories/create-categories.html) and [Edit categories](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/manage-in-the-back-office/categories/edit-categories.html). For information about importing child categories, see [File details: category.csv](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/import-and-export-data/categories-data-import/import-file-details-category.csv.html).

On the Storefront, in comparison to parent category names, child category names are indented so that they can be identified.

In the image below, the Cameras & Camcorders parent category has the Digital Cameras, Camcorders, Actioncams, and Dashcams child categories. Cameras & Camcorders is a root category, so it cannot have a parent one.

![parent-category.png](https://spryker.s3.eu-central-1.amazonaws.com/docs/Features/Catalog+Management/Category+Management/Category+Management+Feature+Overview/parent-category.png)

## Category templates

A Back Office user defines the visual representation of a category on the Storefront by assigning a template to the category. For information about how to do that, see [Create categories](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/manage-in-the-back-office/categories/create-categories.html).

For more information about types of category templates, see [Category page template types](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/manage-in-the-back-office/categories/create-categories.html#reference-information-template).

## Category filters

Through category filters, you can locale items better and add customizable category filters to the catalog pages on the Storefront. They also let you add, rearrange, and define filters for any given parameter in the category tree, such as price or brand. For details about how a Back Office user can add and manage category filters, see Managing category filters.

### Filter preferences

The default filter functionality includes *standard filters* and *dynamic filters and facets*.

#### Standard filters

On the Storefront, the standard filters let buyers narrow down the search results by filtering products according to the specified price range, product ratings, product labels, color, material, and brand. For more details about standard filters, see [Standard filters](/docs/pbc/all/search/{{page.version}}/base-shop/search-feature-overview/standard-filters-overview.html).

#### Dynamic filters and facets

Compared to standard filters, dynamic filters and facets allow the creation of more advanced filter options. For example, you can customize facet filters for any product attribute: the design, quantity of filters, or order criteria by which filters are displayed on the Storefront. For more details about how to configure the filter preferences in the Back Office, see [Edit filter preferences](/docs/pbc/all/search/{{page.version}}/base-shop/manage-in-the-back-office/filter-preferences/edit-filter-preferences.html).

## Video tutorial
Check out this video on managing categories:

{% wistia g3l3c7xt93 960 720 %}

## Current constraints

The Category Management feature has the following functional constraints, which are going to be resolved in the future:

* A category page is accessible by the same URL across all the stores. If the category is not available in the given store, the URL will lead to a 404.
* Root categories cannot be created in the Back Office. They are imported through CSV files.
* A store can only be linked to one root category tree, but in the future, a store can have multiple root category trees.
* Category URLs are locale-dependent.
* Category URLs are available in all the stores that share the same locales.
* Price Range Filter is not supported with merchant relations. That is why this filter is not included in the [B2B demo shop](/docs/scos/user/intro-to-spryker/b2b-suite.html). However, in the [B2C demo shop](/docs/scos/user/intro-to-spryker/b2c-suite.html), you can still filter the products using the price range filter.

## Related Business User documents

| BACK OFFICE USER GUIDES |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Create a category](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/manage-in-the-back-office/categories/create-categories.html) |
| [Assign products to categories](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/manage-in-the-back-office/categories/assign-products-to-categories.html) |
| [Edit categories](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/manage-in-the-back-office/categories/edit-categories.html) |
| [Order products in categories](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/manage-in-the-back-office/categories/order-products-in-categories.html) |
| [Delete categories](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/manage-in-the-back-office/categories/delete-categories.html) |

## Related Developer documents

| INSTALLATION GUIDES | UPGRADE GUIDES | GLUE API GUIDES | DATA IMPORT | TUTORIALS AND HOWTOS |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Install the Category Management feature](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/install-and-upgrade/install-features/install-the-category-management-feature.html) | [CategoryGui migration](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/install-and-upgrade/upgrade-modules/upgrade-the-categorygui-module.html) | [Retrieving category trees](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/manage-using-glue-api/categories/glue-api-retrieve-category-trees.html) | [File details: category.csv](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/import-and-export-data/categories-data-import/import-file-details-category.csv.html) | [HowTo: Manage a big number of categories](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/tutorials-and-howtos/howto-manage-a-big-number-of-categories.html) |
| [Product + Category feature integration](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/install-and-upgrade/install-features/install-the-product-category-feature.html) | [Category migration](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/install-and-upgrade/upgrade-modules/upgrade-the-category-module.html) | [Retrieving category nodes](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/manage-using-glue-api/categories/glue-api-retrieve-category-nodes.html) | [File details: category_template.csv](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/import-and-export-data/categories-data-import/import-file-details-category-template.csv.html) | |
| [Install the CMS + Category Management feature](/docs/pbc/all/content-management-system/{{page.version}}/base-shop/install-and-upgrade/install-features/install-the-cms-category-management-feature.html) | [CategoryPageSearch migration](/docs/pbc/all/search/{{page.version}}/base-shop/install-and-upgrade/upgrade-modules/upgrade-the-categorypagesearch-module.html) | | [File details: category_store.csv](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/import-and-export-data/categories-data-import/import-file-details-category-store.csv.html) | |
| [Category Management + Catalog feature integration](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/install-and-upgrade/install-features/install-the-category-management-catalog-feature.html) | [CategoryStorage migration](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/install-and-upgrade/upgrade-modules/upgrade-the-categorystorage-module.html) | | | |
| [Install the Category Management Glue API](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/install-and-upgrade/install-glue-api/install-the-category-management-glue-api.html) | [ProductCategoryStorage migration](/docs/pbc/all/product-information-management/{{page.version}}/base-shop/install-and-upgrade/upgrade-modules/upgrade-the-productcategorystorage-module.html) | | | |
Loading

0 comments on commit b0fcf1a

Please sign in to comment.