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


Configurable Products

In the Configurable Products section, you can customize the way a matrix form for a configurable product is displayed on a product page, product listing, and on the shopping list page.

A matrix form is applied to a configurable product with up to two attributes.

To configure a matrix form view for a particular case:

  1. Clear the Use Default check box next to the corresponding view page and select the necessary option from the list.

  2. The options available are:

    • 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. For Product Views, the options will look the following:

  4. For Product Listings:

  5. For Shopping Lists:

  6. Allow To Add Empty Products — If enabled, 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 option and then the check box of the option itself.


In the Variations section, 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.

To configure the required settings for simple products variations:

  1. 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 products that belong to the configurable one on the product listing and search results pages enabling a customer to select only the configurable one.

  3. Click Save Settings.