Using the actions “Add source product relation” and “Add target product relation” you can create relations between products, variants or items. Learn more
Add source product relation
Using the action “Add source product relation” you can, for example, create relations between multiple source products and a single target product.
Call up the target product using the search function
For example, in order to create a product relation for a selected source product, whereby the target product is called-up via the search function in the dialog box, proceed as follows:
- In the respective product data table, tick the source product.
- Click on the
button
in the footer to access the action menu. - Move the mouse cursor over the option “Relation”
to show the corresponding submenu. - Click on the option “Add source product relation”
to call up the corresponding dialog box.

- In the "Source items" menu
, tick the product in order to specify it as the source product. - From the "Relation type" menu
, select a relation type. Here you can specify the relation the source product has to the target product. - Optional: In the "Order" field
, enter an integer value. This values specifies the position the product relation takes in a sequence of multiple product relations.

- Optional: Select a counter relation from the "Counter relation" menu
*. Here you specify the relation the target product has to the source product. This allows you to relate articles in both directions. - From the "Increment order" menu
, select the respective option to specify whether the order values of product relations are counted upwards automatically. - In the right-side card, enter the product number of the intended target product in the "Product number" field
. - Click on the button
to trigger the search.
Once the search was carried out, the corresponding product is listed below. - Tick the product
to specify it as the target product.
- To finalise the creation of the product relation, click on the button
.
The dialog box closes and a success message is shown. The product relation is now created. - To cancel the creation of the product relation, click on the button
.
- If you want to specify a variant or an item of the target product as the target for a product relation, you can use the filter functions to filter the list of variants and items.
- *The ipim.web.reverse-relation.hide property needs to be set to “true”. Otherwise the “Counter relation” menu is not shown.
Call up the target product via the active selection
For example, in order to create a product relation for a selected source product, whereby the target product is called-up via the search function in the active selection, proceed as follows:
- In the respective product data table, tick the source product.
- Click on the
button
in the footer to access the action menu. - Move the mouse cursor over the option “Relation”
to show the corresponding submenu. - Click on the option “Add source product relation”
to call up the corresponding dialog box.

- In the "Source items" menu
, tick the product in order to specify it as the source product. - From the "Relation type" menu
, select a relation type. Here you determine the relation the source product has to the target product. - In the "Order" field
, possibly enter an integer value. This values specifies the position the product relation takes in a sequence of multiple product relations.

- Select a counter relation from the "Counter relation" menu*
. Here you can specify the relation the target product has to the source product. This allows you to relate articles in both directions. - From the "Increment order" menu
, select the respective option to specify whether the order values of product relations are counted upwards automatically. - Move the "Active search mode" toggle switch
to the
position. - From the "Data view" menu
, select the option "Products".
The products from the active selection are shown in the right-hand card. - Optional: Enter a search term in the search field
to filter the list of products by a search term. - Tick the designated target product
.
- To finalise the creation of the product relation, click on the button
.
The dialog box closes and a success message is shown. The product relation is now created. - To cancel the creation of the product relation, click on the button
.
- The “Active search mode” toggle switch is inactive unless there are products in the active selection.
- *The ipim.web.reverse-relation.hide property needs to be set to “true”. Otherwise the “Counter relation” menu is not shown.
Add target product relation
Using the action “Add target product relation” you can, for example, create relations between multiple target products and a single source product.
Call up the source product using the search function
For example, in order to create a product relation for a selected target product, whereby the source product is called-up via the search function in the dialog box, proceed as follows:
- In the respective product data table, tick the target product.
- Click on the
button in the footer to access the action menu. - Move the mouse cursor over the option “Relation” to show the corresponding submenu.
- Click on the option “Add target product relation” to call up the corresponding dialog box.
- The “Target items” field
shows the selected target product. Possibly click on the “Target items” field to access the menu that is situated behind it. Here, the selected target product is ticked and can be unticked to deselect it. - Select a relation type from the “Relation type” menu
. Here you can specify the relation which the source product has to the target product.

- In the “Order” field
, possibly enter an integer value for the order. If there are multiple product relations for the source products, the respective integer values determine the order in which the related products, variants or items are listed. - Possibly select a counter relation from the “Counter relation” menu*
. Here you can specify the relation which the target product has to the source product. In this manner you can relate products in both directions. - From the “Increment order” menu
, select the respective option to specify whether the order values of product relations are counted upwards automatically. - In the right-side card, enter the product number of the intended source product in the “Product number” field
. - Click on the button
to trigger the search. Once the search was carried out, the corresponding product is listed below. - Tick the product
to specify it as the source product.
- To finalise the creation of the product relation, click on the button
.
The dialog box closes and a success message is shown. The product relation is now created. - To cancel the creation of the product relation, click on the button
.
- If you want to specify a variant or an item of the source product as the source for a product relation, you can use the filter functions to filter the list of variants and items.
- *The ipim.web.reverse-relation.hide property needs to be set to “true”. Otherwise the “Counter relation” menu is not shown.
Call up the source product via the active selection
For example, in order to create a product relation for a selected target product, whereby the source product is called-up via the active selection, proceed as follows:
- In the respective product data table, tick the target product.
- Click on the
button in the footer to access the action menu. - Move the mouse cursor over the option “Relation” to show the corresponding submenu.
- Click on the option “Add target product relation” to call up the corresponding dialog box.
- The “Target items” field
shows the selected target product. Possibly click on the “Target items” field to access the menu that is situated behind it. Here, the selected target product is ticked and can be unticked to deselect it. - Select a relation type from the “Relation type” menu
. Here you can specify the relation which the source product has to the target product. - In the “Order” field
, possibly enter an integer value for the order. If there are multiple product relations for the source products, the respective integer values determine the order in which the related products, variants or items are listed.

- Possibly select a counter relation from the “Counter relation” menu*
. Here you can specify the relation which the target product has to the source product. In this manner you can relate products in both directions. - From the “Increment order” menu
, select the respective option to specify whether the order values of product relations are counted upwards automatically. - Move the “Active search mode” toggle switch
to the
position. - From the “Data view” menu
, select the option “Products”.
The products from the active selection are shown in the right-hand card. - Optional: Enter a search term in the search field
to filter the list of products by a search term. - Tick the designated target product
.
- To finalise the creation of the product relation, click on the button
.
The dialog box closes and a success message is shown. The product relation is now created. - To cancel the creation of the product relation, click on the button
.
- The “Active search mode” toggle switch is inactive unless there are products in the active selection.
- *The ipim.web.reverse-relation.hide property needs to be set to “true”. Otherwise the “Counter relation” menu is not shown.
Remove product relation
Using the action “Remove product relation” you can revoke an existing product relation from a selected product. To do so, proceed as follows:
- In the respective product data table, tick the product from which you want to revoke a product relation.
- Click on the
button in the footer to access the action menu. - Move the mouse cursor over the option “Relation” to show the corresponding submenu.
- Click on the option “Remove product relation” to call up the corresponding dialog box that lists the product relations where the selected product is the source product.
- Tick the product relation you want to revoke from the selected product.

- In order to finish the process, click on the button.
A success message is shown. The relation is now revoked. - In order to cancel the process, click on the button.
FAQ
What can be done using the “Add product relation” actions?
Using the actions “Add source product relation” and “Add target product relation” you can create relations between products, variants or items. There are different relation types, for example relations between master items and accessory items or the recommendation of matching items.
Why are there two different actions for adding a product relation?
The two actions differ in whether the relation is created starting from one or more selected source products to a target product, or starting from one or more selected target products to a source product.
How can the target product be called up when adding a source product relation?
The target product can be called up either using the search function in the dialog box, by entering the product number and triggering the search, or via the active selection, by moving the “Active search mode” toggle switch.
What does a counter relation do?
The “Counter relation” menu specifies the relation the target product has to the source product. This allows you to relate products, variants or items in both directions.
Why is the “Counter relation” menu sometimes not shown?
The ipim.web.reverse-relation.hide property needs to be set to “true” for the “Counter relation” menu to be shown.
When is the “Active search mode” toggle switch active?
The “Active search mode” toggle switch is inactive unless there are products in the active selection.
Which data sources can be used in addition to the active selection since version 5.4.3?
Since version 5.4.3, the “Active search mode” function considers the most recent search result, the active worklist and the most recently maintained products, in addition to the active selection.
How can you switch between these different context modes?
In order to switch between these options, the user needs to close the dialog box, select the respective context mode in the “Selection” widget and call up the dialog box again.
Rights
Apart from the basic rights listed here, a user needs the rights that are shown in the table.
| Key | Identifier | Description |
| ipim.apps.toolbox.actions | iPIM Apps – Actions | General right that is required to use actions from the action menu |
| ipim-core.api.actions.add-relations | REST – Action – Add relations | Right to use the “Add source product relation” action and the “Add target product relation” action |
| ipim-core.api.actions.remove-relations | REST – Action – Remove relations | Right to use the “Remove product relation” action |