Related Products, Up-Sells, and Cross-Sells

You can use product relations to create links between products. After doing so, one product displays other linked products. To add a product relation, you must choose from one of the available relation types. Then you can use a product publisher and choose the appropriate relation type to display linked products relative to the product featured on the page.

When placing multiple product publisher widgets on a product detail page, multiple sets of related products may appear. For instance, one widget can display alternatives while another can display accessories to the product featured on the page.

Here is a list of product relations that come with the Minium and Speedwell site initializers:

Up-Sell: products with a higher sale value comparable to the featured product.

Spare: spare parts or components of the featured product.

Related: a catch-all set.

Accessories: add-on products for use in conjunction with the featured product.

Cross-Sell: products complementary to the featured product.

Liferay DXP 2024.Q1+/Portal GA112+ There are two more product relations used in product bundles. See Creating Bundles Containing Product Relations for more information.

Adding a New Product Relation Type

If you’re not using a site initializer or want more product relations, you can add them as needed.

1. Open the Global Menu () and navigate to Control Panel → System Settings.

2. Go to Commerce → Catalog and choose Product Relations from the left menu.

3. Click Add.

4. Enter the name of the relation in the Type field.

   

5. Click Save.

Creating Relationships Between Products

1. Open the Global Menu () and navigate to Commerce → Products.

2. Select a product.

3. Go to Product Relations.

4. Click Add () and select Add Related Product.

   

5. Search for products and use the checkbox to select them.

6. Click Add.

   

The two products (Brake Fluid and Brake Rotors) are now associated with the selected product (Brake Pads). This relationship is unidirectional. You can see brake fluid and brake rotors as related products when viewing brake pads. But the opposite is not true. To display product relations, you must configure a product publisher widget.

Displaying Product Relations

You can display product relations on a product display page by configuring a product publisher widget. You must have a product display page in place first.

1. After adding the product relations to a product and creating a product display page, go to the specific product’s product display page.

2. Click Edit () and add a product publisher widget below the product details widget.

3. Click Actions () and select Configuration.

4. Select Product Relations related from the Data Source dropdown menu.

   

5. Click Save and close the dialog box.

   

The two related products appear in the product publisher widget. This is contextual and changes when you select a different product. If the chosen product doesn’t have related products, the widget appears empty.

Commerce 2.1 and Below

Adding a New Product Relation Type

If you’re not using a site initializer or want more product relations, you can add them as needed.

1. Go to the Control Panel → Configuration → System Settings.

2. Click Catalog in the Commerce section.

3. Click Product Relations on the left menu.

4. Click the Add button.

5. Enter the new Product Relation in the Type field: Warranties.

6. Click Save.

   

This adds a new product relation.

Creating Relationships Between Products

1. Go to the Control Panel menu → Commerce → Products.

2. Select any product; for example, Brake Pads.

3. Click on the Product Relations sub-tab.

4. Click on Related in the left menu.

   

5. Click Add () to add one or more relationships.

6. Click Add.

   

The two products (Brake Fluid and Brake Rotors) are now associated with the selected product (Brake Pads). This relationship is unidirectional. You can see brake fluid and brake rotors as related products when viewing brake pads. But the opposite is not true. To display product relations, you must configure a product publisher widget.

Displaying Product Relations

You can display product relations on a product display page by configuring a product publisher widget. You must have a product display page in place first.

1. Search for a product (for example Brake Pads).

2. Click Brake Pads to view the Product Details.

3. Scroll to the bottom of the page to view the related products listed in the Product Publisher widget.

   

4. Click Actions () and select Configuration.

5. Select Product Relations related from the Data Source dropdown menu.

   

6. Click Save and close the dialog box.

   

The example above shows how different products could be related, ensuring that customers can see the full range of products that may also be potentially useful.