What's new in Serenity?
Discover our features per version

Heads up! This is the documentation for our Akeneo Serenity version. Serenity clients benefit from exclusive access to the latest Akeneo PIM features.
If you're interested in other PIM versions, click on the drop down menu on the top right corner or check out everything you need to know about your version.

Associations of products

#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.

View the associated products

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). View the number of associations

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

No association

#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, there is a picker to select the products or product models you want to associate. 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 Add association
  5. The picker to select product or product models opens Add association product picker
  6. Filter on the categories, on 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 Tick products to associate
  8. Click on the Confirm button
  9. The products or product models you associate to the current product are displayed in the Associations tab View the associated products

A product can also be associated to a product model.

#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.) Select an association type
  5. Click on Add associations
  6. The picker to select product or product models opens Associations products picker
  7. Filter on the categories, on 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: Tick products to associate
  9. Click on Confirm
  10. The products or product models you associate to the current product are displayed in the Associations tab View the associated products
  11. Adjust the quantities for each associated product/product model Adjust associated products quantities
  12. Click on 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 per one product/product model.

#Remove associations from a product

To remove an association:

  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 on Save

Remove associations

If you wish to remove associations with quantities, the 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 the step 5.

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


Want to find out more? Take a look at these related articles