Collections

Collections are used to categorize and organize your catalog. A collection contains multiple product variants, and a product variant can belong to multiple collections. Collections can be nested to create a hierarchy of categories, which is typically used to create a menu structure in the storefront.

Collections are not only used as the basis of storefront navigation. They are a general-purpose organization tool which can be used for many purposes, such as:

• Creating a collection of "new arrivals" which is used on the homepage.
• Creating a collection of "best sellers" which is used to display a list of popular products.
• Creating a collection of "sale items" which is used to apply a discount to all products in the collection, via a promotion.

Collection filters

The specific product variants that belong to a collection are determined by the collection's CollectionFilters. A collection filter is a piece of logic which is used to determine whether a product variant should be included in the collection. By default, Vendure includes a number of collection filters:

• Filter by facet values: Include all product variants which have a specific set of facet values.
• Filter by product variant name: Include all product variants whose name matches a specific string.
• Manually select product variants: Allows manual selection of individual product variants.
• Manually select products: Allows manual selection of entire products, and then includes all variants of those products.

Collections often work hand-in-hand with facets and filters to provide structured navigation in your storefront.

Filter inheritance

When a collection is nested within another collection, the child collection can inherit the parent's collection filters. This means that the child collection will combine its own filters with the parent's filters.

In the example above, we have a parent collection "Menswear", with a child collection "Mens' Casual". The parent collection has a filter which includes all product variants with the "clothing" and "mens" facet values. The child collection is set to inherit the parent's filters, and has an additional filter which includes all product variants with the "casual" facet value.