Skip to main content

Pentaho+ documentation has moved!

The new product documentation portal is here. Check it out now at


Hitachi Vantara Lumada and Pentaho Documentation

Get started with Dashboard Designer

Dashboard Designer allows you to create dashboards with little or no training. The dashboard is several different reports brought together inside one screen. Use Dashboard Designer if you want to create an interface to view many different reports at once, have quick access to web pages that you visit often, or view dynamic charts and graphs within a space while you create reports in another.

View a Dashboard sample

This section highlights some popular Dashboard Designer capabilities that are available, using the sample dashboard called Sales Performance (Dashboard), located in the Getting Started widget.


  1. In the Getting Started widget on the Home page, click the Samples tab.

  2. Scroll down to find the Sales Performance (Dashboard) sample. Click Explore to open a new browser screen, then click the Samples tab.

  3. Scroll right in the horizontal list of items (at the bottom of the screen). Find Sales Performance (Dashboard) and click it to view the sample.

    Dashboard sample

Tour the Dashboard panels

You can view the editable version of the Sales Performance (Dashboard) in Dashboard Designer by clicking Browse Files on the User Console Home page.

Follow these steps:


  1. In the Folders pane, click to expand the Public folder, then click to highlight the Steel Wheels folder.

  2. In the center pane, double-click Sales Performance (Dashboard).

  3. After the dashboard opens, click Edit in File Actions.

    Dashboard example
    1Opened pageDisplays quick access buttons across the top to create and save a new Analysis Report, Interactive Report, and Dashboard. Opened reports and files show as a series of tabs across the page.
    2Prompts panelThe prompts panel gives you a way to add filters to the individual parts of your dashboard.
    3Browse and Files panelLocate your files using the Browse and Files panels, and add them to dashboards.
    4Dashboard canvasShows a dynamic view of your dashboard as you work to build it. The look of your dashboard refreshes as you add content from the Browse and Files panels, and work with the prompts or Objects panels.
    5Objects panelRefine the look of your dashboard with the Objects panel by choosing a dashboard template or changing the titles for each object in the dashboard.

Create your first dashboard

Follow the steps below to create your first dashboard:


  1. From the User Console Home page, click Create New, then choose Dashboard.

  2. In the Edit pane, click the Templates tab and select the 2 over 1 layout to use for this exercise.

  3. Click the Properties tab, and type My Dashboard in the Page Title text box.

    This is the title for your dashboard page. Properties tab, Dashboard
  4. Click the Themes tab and select the theme of your choice.

    The new theme will be applied to your dashboard immediately.
  5. Locate the Analyzer report you created earlier by going to the Browse pane to the left of the dashboard canvas and clicking on the folder you used before. Click-and-drag the Territory - Sales file from the Files pane and onto the top-left dashboard panel.

    Drag and drop into dashboard
  6. Within the Edit pane, type Territory - Sales in the Title text box and click Apply.

    The dashboard panel is populated with the Territory - Sales report.
  7. Locate your Interactive report through the Browse pane. Click-and-drag the In Stock Report file from the Files pane and onto the top-right dashboard panel.

  8. Within the Edit pane, type In Stock Report in the Title text box and click Apply. Enter a title for this dashboard panel and click Apply.

    The right dashboard panel is populated by the In Stock report.
  9. You can drag any report from the Steel Wheels folder in Public into the bottom dashboard panel. Enter a title for this dashboard panel and click Apply.

  10. Click the Save as icon in the toolbar. When the Save As dialog box appears, save your dashboard as My Dashboard and click Save.

  11. Close the dashboard (click the X to close it in the tabs at the top), then go to Browse Files and double-click on My Dashboard in the Files pane.

    Created dashboard


You have successfully created a simple dashboard from scratch. Pentaho Dashboard Designer illustrates how to work with complex dashboards.