Skip over navigation
You are currently viewing documentation for a previously released version of OroCRM. See the latest long-term support version.

Dashboards and Widgets

Dashboard is a default page you see after you log in. It is an adjustable view that may contain many types of information blocks (widgets), such as today’s calendar, recent calls and emails, quick launchpad, etc. You can have several dashboards that serve different purposes and switch between them.


In this section you will learn how to easily customize existing dashboard or create a new one, as well as add and manage widgets in the Oro application.

Create a Dashboard

To create a dashboard:

  1. Hover over the in the main menu and click Manage Dashboards.

  2. Click Create Dashboard on the top right of the page.

    The following page appears:


    The following fields are mandatory and must be specified:

    Field Description
    Label Name used to refer to the dashboard in the system.
    Clone from Choose an existing dashboard to be used as a base for a new one. If you want to create a dashboard from the scratch, choose the Blank Dashboard option.
    Owner Limits the list of users who can manage the dashboard to the users, whose roles allow managing dashboards of the owner (e.g. the owner, members of the same business unit, head of the department, etc.)
  3. To save the dashboard, click Save and Close on the top right.

Initially, the dashboard contains all the widgets of the dashboard it has been cloned from. Dashboards cloned from the Blank Dashboard will be empty.


Manage Dashboard

Switch Between Dashboards

You can switch to a dashboard in one of the two ways:

  • Hover over the in the main menu and click the dashboard name.

  • Toggle dashboards in the header of the Dashboard page.


Explore Out-of-the-box Widgets

Your Oro application comes with a number of out-of-the-box widgets that can simplify the day-to-day sales, marketing and communication activities. These can be broken down into three categories:

Widgets for Sales and Marketing Widgets for Communication Universal Widgets Magento-related Widgets


Additional widgets can be added via a third-party system integrations.

Add Widgets to a Dashboard

To add a widget to a dashboard:

  1. Navigate to the dashboard (e.g. hover over the in the main menu and click the dashboard name).

  2. Click +Add Widget.

  3. The page that appears lists all the widgets available in the system which have not been added to the dashboard yet.

  4. To search for a widget, type its name in the search field.

  5. Select the widget that you would like to add and click Add.


This way you can add the same widgets a number of times and assign them different owners.


You can add the same widgets a number of times and assign them different owners.

Manage Widgets on a Dashboard

Widgets can be easily managed and filtered. A number of widgets can be created for various team members. For instance, a sales manager can create the same widgets for each sales rep within the organization to be able to see results of each sales rep’s work.

Manage widgets using the tools in their header:


The header of each widget contains:

  • The Collapse/ Expand button — If a widget has been collapsed, only its header will be displayed on the dashboard.
  • Widget name — Widget title displayed on the dashboard.
  • The Move button — Click and hold the button while moving the widget around the dashboard.
  • The Delete button — delete the widget from the dashboard
  • The Settings button — Click the button to adjust the widget. See the Adjust Widget Settings section for the options you can change.

The specified owner, date range and the territory (if available for the entity) are displayed at the bottom of the widget:


Adjust Widget Settings

By clicking in the widget header, you can adjust the following settings:

  • Widget title — the name displayed on the dashboard.
  • Business unit — select the business unit to present statistics for.
  • Role — select the user’s role (e.g. a sales manager, an administrator, a leads development rep, etc.) to see statistics for.
  • Owner — select the owner for the widget to see statistics for a certain user.
  • Date range — time for which the widget details are displayed.
  • Compare with previous period — tick this option if you wish to compare statistics for the current and the previous periods and see it displayed in the dashboard widget.
  • Other widget details (depending on widget type).

Add, Edit, and Delete a Dashboard

Manage the widgets via the Tools menu. Hover over the Tools and use one of the following actions:

  • Click to edit the dashboard.
  • Click to create a new dashboard.
  • Click to delete the dashboard from the system.


You can also perform these actions via the More Options menu from the Dashboards list page (Dashboards > Manage Dashboards in the main menu).

Browse maintained versions:
Back to top