Important

You are browsing upcoming documentation for version 6.1 of OroCommerce, scheduled for release in 2025. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

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

Configure Global Theme Settings 

In your Oro application, you can control and customize the storefront look and feel.

Hint

Theme is configurable on three levels – globally, per organization and website.

You can set the following theme-related options that apply globally by default:

  • Pre-designed theme for the storefront

  • The layout for the product page details

  • Style of the selector in filters

  • Display mode for the user menu in the storefront, and more

To configure the storefront theme options globally:

  1. Navigate to System > Configuration in the main menu.

  2. Select Commerce > Design > Theme in the menu to the left.

    Note

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

  3. In the Theme Settings section, configure the following options:

    • Theme — select the storefront theme from the list. For more details on how to customize a theme from the dropdown list, refer to the theme configuration topic.

    • Product Image Placeholder — select the image file that will appear on the product listing and product view pages for the products that have no associated images to avoid a blank image page.

    • Category Image Placeholder — select the image file to be applied to the category that has no associated image. The image is usually used in various category widgets.

    • Display Price Tiers As — Select a multi or single unit table. A multi-unit table shows price tiers for all product units in the same table, which might not work well for products with many units or when quantity tiers are not aligned between units. Single-unit table shows price tiers only for the currently selected unit.

  4. In the Page Templates section, select the product page template from the list. A page template is used to render the product page in the storefront by default, unless the template is overridden in the product details. Available options are Default, Tabs, Wide.

Important

The Page Templates configuration applies to OroCommerce version 5.1 and below. To configure the setting for the Refreshing Teal theme, please refer to the theme configuration documentation.

  1. In the Filter Settings section, specify how the multi-select filters should look in the storefront. Available options are Drop-down and All at once.

  2. In the Menu Templates section, select the user menu display mode that defines the look and feel of the user menu in the storefront.

Important

The Menu Templates configuration applies to OroCommerce version 5.1 and below. To configure the setting for the Refreshing Teal theme, please refer to the theme configuration documentation.

  1. In the Filter Settings section, specify how the multi-select filters should look in the storefront. Available options are Drop-down and All at once.

    Illustration of the multi-select filter displayed in the drop-down and all at once in the storefront

  2. In the Grid Settings section, configure the following options:

    • Responsive Grids — This option makes storefront grids responsible, realigning row cells to fit various screen sizes.

    • Swipe Actions Grids — This option enables swipe actions for the storefront grids on mobile devices.

  3. Click Save Settings.