You are browsing the documentation for version 4.2 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

Manage Content Widgets in the Back-Office


This section is part of the Content Management Concept Guide topic that provides the general understanding of the tools that help manage the content of your website, such as web catalog, landing page, content blocks, widgets, and WYSIWYG editor.

Content widgets are snippets of structured information that you can insert into any WYSIWYG field in your application. WYSIWYG fields are available throughout OroCommerce; for example, in category descriptions, on edit pages of products, content blocks, and landing pages.

There are four content widget types:

  • An Image Slider

  • A Contact Us form

  • A Product Mini Block

  • A Product Segment

Each of these widget types has a different set of options.

Please keep in mind that:

You can:

  • Edit content widgets from the grid and view page.

You cannot:

  • Delete a widget if it is used in a content block or a landing page.

  • Change widget type for an already existing widget.


Whenever you modify a content widget, changes are applied everywhere the widget is used.

Create a Content Widget

To create a new content widget:

  1. Navigate to Marketing > Content Widgets in the main menu.

  2. Click Create Content Widget on the top right.


    If you have more than one organization in your OroCommerce application, first select which organization to add a new content widget to.

  3. Depending on the widget type, form fields are different:

    • Contact Us Form - Enables you to add a standard Contact Us form.

    Contact us content widget form
    • Image Slider - Enables you to configure and add an image slider.

    Image slider content widget form


    You can add as many slides as necessary by clicking Add at the bottom of the Slides section.

    Image slider content widget form
    • Copyright - Enables you to add a full or shortened version of a copyright notice.

    Copyright content widget form

    • Product Mini Block - Enables you to add a block with product information with or without prices, and/or the Add to Shopping List button.

      A product mini block form

    • Product Segment - Enables you to add a product segment content widget, and configure how many max and min items to show, whether to use slider on mobile, and show the Add to Shopping List button in the storefront. Only segments with type Product are listed in the Segment field dropdown. You can modify an existing segment or create a new one under Reports&Segments > Manage Segments.

      A product mini block form

  4. Once you have provided all widget-specific details, click Save and Close.

    Content widget view page


    Each content widget may have various representations in the form of layouts. Layouts are defined by developers using the existing layout update functionality, which enables you to alternate between the pre-configured designs for each widget in the back-office.

    Select Layouts in the back-office

    Please be aware that layouts are theme-specific. For more information, please refer to the CMS bundle documentation.