Associations of products

Summary

Overview

A product may be associated with none or several other products or product groups. This type of link has a direction: 1-way or 2-way. Please read our Association Types documentation for more information.

These types of associations enable you to define relationships, such as an alternative product, a substitution between products, a cross-sell/up-sell option, or even a product set composed of different quantities of products.

 

View the product’s associations

To check the association types:

  1. Open the relevant product edit form
  2. Click on the Associations tab
  3. Click on the association type name on the left-hand side
  4. Click on the Show groups button on the right-hand side of the tab to display the product groups grid
  5. Click on the Show products button on the right-hand side of the tab to display the product grid

 

You can define associations on product models, please refer to this article for more details.

 

 

Only the associated products or product models are displayed in the Associations tab.

 

The total number of associations is displayed per product or product model (the figure is visible after the Associations tab label) and per association type (figure visible in the Association type list).

 

 

By default, nothing is displayed in the Associations tab if the product has no association for the selected association type.

 

 

About associations' order

Today, defining a specific order of your associated products/product models is impossible. The current order follows those rules:

  • Associated products are first displayed, then associated product models are displayed after.
  • Associated products/product models are ordered by an alpha-numerical logic based on their internal ID (visible in the URL).

For instance, if you associated the products "e9af9526-08df-4177-a7bc-34016b231d0c", "02255102-39ee-41cd-87af-340d1a3fe5cd", "732b0fe5-1159-4802-8c3d-a68eff1ba158" and the product model "1568", the default order logic will be the following:

  1. Product "02255102-39ee-41cd-87af-340d1a3fe5cd" (it starts with a "0", the lowest figure here)
  2. Product "732b0fe5-1159-4802-8c3d-a68eff1ba158" (it starts with a "7" which comes after "0")
  3. Product "e9af9526-08df-4177-a7bc-34016b231d0c" (it starts with an alphabetical value "e" which comes after numerical values)
  4. Product model “1568”

If you export your associated products/product models using the API or XLSX/CSV files, the order will be the same as explained in the paragraph above.

 

 

Open an associated product

  1. Open the relevant product edit form
  2. Click on the Associations tab
  3. Select the association type
  4. Click on an associated product or product model
  5. The associated product or product model opens in a new tab

 

Add/remove associations to/from a product

To add associations, use the selector to select the products or product models you want to associate with. Depending on the association type selected, there are two different ways to do so:

A: add associations to a product

  1. Open the Product Form
  2. Click on the Associations tab
  3. Select the association type
  4. Click on the Add associations button
  5. The selector to select products or product models opens
  6. Filter on the categories, the label, or identifier, or add filters to find the products or product models to associate.
  7. Tick in the grid the products or product models to associate. They are displayed in the basket:
  8. Click Confirm
  9. The products or product models you associate with the current product are displayed in the Associations tab.

A product can also be associated with a product model.

 

 

If you want to associate your products/product models with 2-way associations via an XLSX/CSV import, please note that the PIM processes the import information line by line. So if different products A & B are associated with the same product C, ensure that product C is also associated with products A & B. Otherwise, the associations made on the previous lines will be removed.

 

B: add associations to a product using an association type with quantities

  1. Create a product or a product model that will be the base of your product set
  2. Open the product form
  3. Click on the Associations tab
  4. Select the association type with quantities you created (please read our Association Types documentation for more information.)
  5. Click on Add associations.
  6. The selector to select products or product models opens
  7. Filter on the categories, the label or identifier, or add filters to find the products or product models you want to associate
  8. In the grid, tick the products or product models to associate. They are displayed in the basket:
  9. Click Confirm
  10. The products or product models you associate with the current product are displayed in the Associations tab
  11. Adjust the quantities for each associated product/product model
  12. Click Save

 

Quantities must be positive integers between 1 and 2,147,483,647.
Using the association type with quantities, please note that you cannot associate more than 100 products/product models (i.e. having 100 different products/product models or 100 lines of product/product models associated) per one product/product model.

 

Quantified associations can't be exported with their respective UUIDs. Only their main identifier will be displayed in the export file. Caution when re-importing the same file if some of your products don't have a main identifier as the association would be removed. 

 

 

Import associations

If you're adding associations using a product import, please note that it is impossible to add them for a product or a product model whose identifiers are missing from the import file.

For instance, if you import a file with products (e.g., Product A, Product B, Product C, and Product D) and add associations in Product D with products not included in the file (e.g., Product E and Product F), these associations won't be imported. However, associations added in Product D with products present in the file (e.g., Product A, B, or C) will be imported.

Remove associations from a product

  1. Open the Product Form
  2. Click on the Associations tab
  3. Select the association type
  4. Hover a product or product model associated
  5. Click on the cross to remove the association
  6. Click Save

If you wish to remove associations with quantities, step 4 won't be available as the associated products will be displayed as a list, not as a gallery. In that case, please skip it to step 5.

 

A product associated using a 2-way association will be removed on both sides. Please read our Association Types documentation for more information.