In VTEX Admin, you can register a similar category at product level or category level, as shown in the next sections.
To register a similar category at via Catalog API, use the Add similar category endpoint.
Configuring similar category at product level
Configuring a similar category in a product causes the product to be displayed on the page of the category registered as similar, in addition to its original category.
Only the main product category will define the fields, specifications and filters. For example, if a product is in the main category Cups and the similar category Jars, when you access the Jars category, you will not see the American Cups filter (which is part of the main Cups category).
Similarly, if you filter for Glass Cups in the Jars category, you will not see the glass cups, since it is impossible to populate a similar category field for a product in the main category.
To configure a similar category at product level, follow the steps below:
- In the VTEX Admin, go to Catalog > Products and SKUs, or type Products and SKUs in the search bar at the top of the page.
- Click on the desired product line, or click on the product three-dot menu >
Edit product
. If you are creating the product, check out the article Adding or editing products. - In the Storefront section, add the desired categories in the Similar Categories field.
- Click
Save
.
Configuring similar category within a category
This setting is only compatible with stores using Legacy CMS Portal.
When editing a category, you can set up its like category. When you complete this kind of configuration at category level, the navigation menu will display a link to the similar category at the original category level.
To configure a similar category at category level, follow the steps below:
- In the VTEX Admin, go to Catalog > Categories, or type Categories in the search bar at the top of the page.
- Click
Show All
to view all options, then on the desired category. - Click
Actions
. - Click the
Include Similar
option. This will open the list of similar categories in that category. - Click
New Similar Category
. - Click
Select Category
. When you do this, a new window will open with the list of all categories. - Click
Show all
to view all of the categories available, and then click on the desired category. - Click
Save
.