Menu
Feedback
Start here
Tutorials


Tutorials
Explore in-depth tutorials for operating your VTEX store.
Tutorials
Storefront
Layout
Adding collections CMS
5 min read

There are two ways to configure collections: through the Legacy CMS Portal or the Collections Beta module. This article is about how to configure collections through the Legacy CMS Portal.

Follow the steps below to add a new collection:

  1. In the VTEX Admin, access Storefront > Layout.
  2. In the CMS folder, click on Product Clusters (Collections).
  3. Click on New Collection.
  4. Fill out the Collection form fields. For more on the meaning of each one of these fields, read our article on how to fill out new collection fields.
  5. Click on Save Product Cluster.

When the number of created collections surpasses twenty, those exceeding that number can be found through the search field on the admin interface. Search by the name of the collection you want to find.

Choosing the products that will make up a collection is done by clicking on New Group in the desired collection, creating a group.

{"base64":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAQAAAAECAIAAAAmkwkpAAAACXBIWXMAAA7DAAAOwwHHb6hkAAAAPUlEQVR4nGPo7W6bNHnyvXv3/v//z5CbnczNzXXs+AkQZ+XyxXZ2NuV5BXt37WK4dvVKRXnJ0rnzvn/7BgAJWx5xVW2RgwAAAABJRU5ErkJggg==","img":{"src":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Layout/adding-collections-cms_1.png","width":267,"height":239,"type":"png"}}

Before choosing which products to add to a group, you will need to give it a name and specify which type the created group falls under.

Group Types

There are only two possible values for a group type: Inclusive or Exclusive. An inclusive group includes its products in the collection to which it is linked. Meanwhile, an Exclusive group does the opposite, removing its products from a collection.

For example, we have a collection called Cellphones, comprising two groups: group A is an Inclusive type while B is an Exclusive type. The products belonging to this collection will be the result of group A products minus group B products.

This logic is used for any number of groups created within the same collection. Exclusive group products will always be subtracted from any Inclusive type groups, as follows:

Products comprising a collection = (A+B) - (C+D)

Of which:

  • Groups A and B are type Inclusive
  • Groups C and D are type Exclusive

To this end, the first group that is created in any collection must necessarily be type Inclusive.

Be mindful of the set group type. When adding products to an Exclusive group type, for example, these will not be added to a collection due to the nature of the group.

Selecting Products

In a group, you can select a product based on the following:

  • Department, Category or Subcategory
  • Brand
  • SKU
  • Launch Date

You can select more than one of the options above to achieve a specific scenario. In such cases, only products falling within the intersection of both options will be included in the group.

For example: When selecting a category A and a brand B, only products pertaining simultaneously to this category and brand will be included in the group. Category A products pertaining to brands other than B will not be part of the collection. The same applies for brand B products of other categories.

Products by Department, Category or Subcategory

To add the products of a specific department to a group, select the desired department and click on Save Group, as shown in the image below.

{"base64":"  ","img":{"width":736,"height":450,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":30362,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Layout/adding-collections-cms_2.png"}}

The same applies for products of a specific Category or Subcategory.

{"base64":"  ","img":{"width":735,"height":477,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":33345,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Layout/adding-collections-cms_3.png"}}

Product by Brand

To create a group containing products from one or more brands, select the desired brand from the corresponding list.

{"base64":"  ","img":{"width":737,"height":473,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":32317,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Layout/adding-collections-cms_4.png"}}

Brands are displayed in alphabetical order. When clicking on the first letter corresponding to the desired brand, the list expands and displays the existing brands.

Products by SKU

Manually

When adding a SKU to a group, the product to which it is linked is also added. If the product is linked to more than one SKU, adding one SKU would also add all other SKUs to the group.

{"base64":"  ","img":{"width":355,"height":389,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":13856,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Layout/adding-collections-cms_5.png"}}

In the find SKUs field, you can type in as many SKU IDs as needed, separating each one by a comma.

Ex.: 200004,200009,200005

To remove an SKU from the list, click on the red button next to it.

When the number of listed SKUs surpasses ten, a page control becomes available.

By spreadsheet

Get the file template for adding SKUs to or removing them from a collection here.

Bulk Upload

You can Bulk insert SKUs by importing an .xls format spreadsheet to list SKUs that will be part of a group.

{"base64":"  ","img":{"width":355,"height":389,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":13740,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Layout/adding-collections-cms_6.png"}}

In the imported spreadsheet, all SKU IDs must be listed in the first column, with a header, as shown in the example below:

{"base64":"  ","img":{"width":346,"height":228,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":5072,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Layout/adding-collections-cms_7.png"}}

After selecting the desired spreadsheet, click on the Import SKUs option to sent the information.

{"base64":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAQAAAABCAIAAAB2XpiaAAAACXBIWXMAABYlAAAWJQFJUiTwAAAAFUlEQVR4nGOQk5fv6ev/+uXL0vnzASNjBsZQF59bAAAAAElFTkSuQmCC","img":{"src":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Layout/adding-collections-cms_8.png","width":543,"height":118,"type":"png"}}

Bulk remove

To avoid having to remove SKUs one at a time, you can use the import function of a spreadsheet to bulk remove them.

{"base64":"  ","img":{"width":386,"height":433,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":16303,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Layout/adding-collections-cms_9.png"}}

In this specific case, the SKUs listed in the imported spreadsheet will be excluded from the group. Do this by clicking on remove SKUs after the file has been loaded.

Disabled SKUs will not be removed or added, even if they appear as listed in the spreadsheet.

Products by Market Launch date

In the Other options section, the Pre-sales and Launches options are add-ons to choosing products by Category, Brand or SKU, meaning that these flags will only work if you have previously selected them.

Note that you can only select one of the two options. Should you want both add-ons, create two groups and configure each one with the respective option.

{"base64":"  ","img":{"width":355,"height":206,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":9289,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Layout/adding-collections-cms_10.png"}}

Pre-sales

In order to create a product collection that has not been launched yet, select the Pre-sales option. The system considers the launch date of all products to be one day after the present date, according to the Market launch date field in the product file.

Launches

The Launches option allows you to create a recently launched product collection. Upon selecting this option, the system considers all of the products that were launched within a 30-day interval prior to the present date. The launch date taken into account is also the same one set in the Market launch date in the product file.

To know more about how to exclude a product collection, read our article on how to delete collections.

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Change a placeholder title
« Previous
Filling out Collection fields
Next »
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
GithubDeveloper portalCommunityFeedback