Skip to main content

Clusters

Clusters group related products as variants of a single item. A cluster uses a cluster definition to determine which attributes (such as Color and Size) create the variant options shown in the storefront.

Cluster detail page showing the Description tab with General section

Before you begin​

  • You need the Product role to view clusters and cluster definitions.
  • Creating or deleting cluster definitions requires Owner access on the Product role.
  • Editing cluster definitions requires non-viewer access.

Manage cluster definitions​

Cluster definitions control which product attributes form the variant selectors for a cluster. Navigate to PIM > Cluster Definitions to view all definitions.

Cluster Definitions list with search and New Cluster Definition button

Create a cluster definition​

  1. Click New Cluster Definition.
  2. Enter a Name in UPPERCASE_WITH_UNDERSCORES format (for example, PRODUCT_MODEL_SHIRT). This name cannot be changed after creation.
  3. Click Add product filters to open the attribute picker.
  4. Select the product attributes that form the variant selectors (for example, Color and Size).
  5. For each attribute, choose a Display Type:
Display typeDescription
ColorColor swatches
DropdownStandard dropdown menu
ImageClickable image tiles
RadioHorizontal option tiles
  1. Drag and drop to set the priority order. This determines the attribute selection sequence in the storefront.
  2. Click Save.

Edit a cluster definition​

Click any row in the cluster definitions list to open the edit dialog. You can add or remove product filter attributes, change display types and reorder attributes by dragging. The definition name cannot be changed.

Edit Cluster Definition dialog with name, product filters and display type dropdown

Delete cluster definitions​

  1. Select one or more definitions using the checkboxes.
  2. Click Delete and confirm.

Edit a cluster​

Navigate to PIM > Products & Clusters and click any cluster row to open the cluster detail page. The detail page has five tabs: Description, Products, Options, Storefront and Attributes.

Edit cluster descriptions​

On the Description tab, update the cluster fields in the General section. A right sidebar provides quick navigation to the General, Categories, Metadata and Properties sections on this tab.

FieldDescription
NameCluster name (supports multiple languages)
Cluster definitionThe definition type. Click the list icon to change it.
CodeCluster SKU or code
PriorityDisplay priority
HiddenToggle to hide the cluster from the storefront
Short descriptionBrief cluster summary with rich text formatting (localized)
DescriptionFull cluster description with rich text formatting (localized)

Manage cluster categories​

Scroll down on the Description tab or click Categories in the right sidebar to view the category assignments for this cluster.

Cluster Description tab showing the Categories section with primary location and linked categories

This section shows:

  • Primary location: the main category path for this cluster.
  • Category ID: the numeric identifier of the primary category.
  • Linked categories: a table listing all categories this cluster belongs to, with name and path columns.

Click Link product to category to assign the cluster to additional categories.

Manage cluster products​

On the Products tab, manage the products (variants) that belong to this cluster. The table shows each product with its image, name and dynamic attribute columns based on the cluster definition.

Cluster Products tab showing variant products with images, names and attribute columns

ActionAccess requiredDescription
Add productNon-viewerCreates a new blank product with default pricing
Move product into clusterNon-viewerOpens a product picker to assign existing products
DeleteOwnerRemoves selected products from the cluster
Move out of clusterNon-viewerMoves selected products to another cluster or category

Use the Is Default radio button to mark which variant is shown by default in the catalogue. You can edit attribute values inline by clicking the edit icon on any attribute cell.

Manage cluster options​

On the Options tab, manage configurable add-on options for the cluster (for example, engraving or gift wrapping). The options list shows each option with its name, description, short description and whether it is required.

Cluster Options tab showing options list with name, description and isRequired columns

  1. Click Add Cluster Option to create a new option.
  2. Fill in the option details:
FieldDescription
NameOption name (localized)
DescriptionFull description (localized)
Short descriptionBrief description (localized)
Is RequiredYes/No radio button to set whether customers must select this option

Cluster option detail page with description fields and Is Required toggle

  1. Click Products in the right sidebar or scroll down to the Products section.
  2. Click Add product to add products that serve as the available choices for this option.
  3. Use the Is Default checkbox to mark which product is selected by default when a customer views the option.

Cluster option products list with Is Default checkbox and product names

Manage storefront relationships​

On the Storefront tab, set up cross-sell and up-sell relationships. The tab contains five collapsible sections:

  • Cross & Up Sell / Accessories
  • Cross & Up Sell / Alternatives
  • Cross & Up Sell / Related
  • Cross & Up Sell / Options
  • Cross & Up Sell / Parts

Cluster Storefront tab showing Cross and Up Sell sections for Accessories, Alternatives, Related, Options and Parts

In each section, click Add products to add individual products or Add product group to add a group. You can remove items and reorder them within each section.

Edit custom attributes​

On the Attributes tab, manage custom cluster-level attributes.