Skip to main content

Cluster Definitions

A cluster definition decides which product attributes become the variant selectors of a cluster, for example Color and Size, and how each one is shown in the storefront. You create the definition first and pick it when you create a cluster.

Before you begin​

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

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.
  • Clusters - create a cluster that uses a definition
  • Attributes - the product attributes a definition can use