You are browsing the documentation for version 1.6 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Available in OroCommerce

Configurable Products

In the system configuration, you can control the way a matrix form and variations of a configurable product are displayed in the storefront. Configurable product information can be set on three levels: globally, per organization, and per website. Website settings override organization, organization settings override the system ones.

To configure configurable products globally:

  1. Navigate to System > Configuration in the main menu.
  2. Select Commerce > Product > Configurable Products in the menu to the left.


For faster navigation between the configuration menu sections, use Quick Search.


Here, you can customize a matrix form view for a configurable product as well as set visibility restrictions for all the simple products that compose the configurable one.

A matrix form is applied to a configurable product with up to two attributes. It can be displayed as follows:

  • On a product page:
  • On the product listing:
  • On a shopping list page:

To configure a matrix form view for a particular case:

  1. Clear the Use Default check box next to the corresponding view page.

  2. Select the necessary option from the following list:

    • No Matrix Form — The option disables the matrix form visibility for a configurable product and displays an alternative table with a possibility to select one simple product within a configurable one at a time.

    • Inline Matrix Form — With this option enabled, the matrix form is displayed next to the product image on the product details page.

    • Popup Matrix Form — The option triggers a popup matrix form upon clicking the Update Shopping List button. Once the popup displays, a customer can select multiple simple products at a time.

    • Group Single Products — The option is available only for the shopping list view. It extracts the single products which were sent to the shopping list from the configurable product matrix.

  3. By default, a customer can add a configurable product with an empty matrix form to a shopping list to manage it later. To disable this possibility, clear the Use Default check box next to the Allow To Add Empty Products option and then the check box of the option itself.

Also, you can control whether to display or hide all the single products within the configurable one.

In the cases where you have plenty of products, you may need to clear the product listing and search results pages from all the variations of the configurable product removing the duplicated information.

  1. In the Variations section, clear the Use Default check box next to the Display Simple Variations field.

  2. Select the necessary option from the list:

    Everywhere — With this option selected, all the simple products are displayed together with the configurable one on a product page, product listing, and a shopping list page.


    Hide Completely — The option hides all the simple product that belong to the configurable one and displays only the latter.

  3. Click Save Settings.