Important

You are browsing documentation for version 5.1 of OroCommerce, supported until March 2026. 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

This can be done 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 (default tabbed view, short, two column, or list)

  • Style of the selector in filters

  • Display mode for the user menu in the storefront

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.

    Global theme configuration settings

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

    • Theme — select the theme from the list. The theme controls general design of the storefront that defines its look and feel. Default and custom themes are available out-of-the-box for the storefront.

    For example, this is how the address book looks in the storefront for the default and custom themes:

    Default theme

    A sample of the Address Book menu in the storefront if the default theme is enabled

    Custom theme

    A sample of the Address Book menu in the storefront if the custom theme is enabled

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

    A sample of the product image placeholder on the product listing 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 (e.g., Featured Categories).

    A sample of the product image placeholder for the on the product listing age

  4. In the Page Templates section, select the product page template from the list.

    This page template is used to render the product page in the storefront by default, unless the template is overridden in the product details.

    Default template (tabbed), Short page, Two-column page, and List page templates are available out of the box. For preview and more information on these options, see the Manage Product Page Design with Page Templates topic.

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

    For example, this is how the user menu looks for different values:

    Drop-down

    Illustration of the multi-select filter dispayed in the drop-down in the storefront

    All at once

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

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

    For example, this is how the user menu looks for different values:

    Show all items at once

    The storefront user menu look when the Show all items at once option is enabled

    Show subitems in a popup

    The storefront user menu look when the Show subitems in a popup option is enabled

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

  8. Click Save Settings.