Skip to main content
Pentaho Documentation

Use Prompts on Dashboards

Prompts display a subset of data based on the dashboard user's point of view. For example, a European user may only want to see EMEA region sales data, whereas the dashboard's default region is the NA region. To ensure that a prompt links to the correct content in a dashboard, the content to which you are linking (data table or chart) must contain at least one parameter.

Below are general instructions below for adding prompts to your dashboard:

  1. In the dashboard page, choose Edit (the pencil icon), which will make the Objects pane appear.
  2. Under General Settings, choose Prompts. The Prompts pane appears on the right. No prompts are listed if this is the first time you are assigning prompts.
  3. To display a prompt toolbar to users of the dashboard, enable Show Prompt Toolbar. The prompt toolbar appears at the top of the dashboard.
  4. Click the Add button to start adding prompts. The Prompts dialog box appears.
  5. In the Prompts dialog box, enter a display name for the control label. For example, 'Region'.
  6. Enable Display Name as Control Label if you want users to see the display name in the prompts toolbar.
  7. Select your control type. Control types define how your prompt values are selected; for example, in a drop down list, radio button, check box, and so on.

    The table below contains a description of each control type.

    Control Type Description
    Drop-down Users select a value from a drop-down list of options.
    List Users select a value from a scrolling list. This prompt control type allows users to make multiple selections.
    Radio button Users click a radio button to choose a value. You can set the radio buttons to display vertically or horizontally.
    Check box Users select a check box to choose a value. This prompt control type allows users to make multiple selections within a set of check boxes. You can set the check boxes to display vertically or horizontally.
    Button Users click a button to choose a prompt value. This prompt control type allows users to make multiple selections within a set of buttons. You can set the buttons to display vertically or horizontally.
    Text field Users manually enter a text string or number into a text field. You can specify maximum characters allowed within the text box and the width of the text box itself.
    Date picker Users examine values based on calendar dates.
Your dashboard now has a prompt.
If you plan to provide hard-coded names and values for your dashboard users, or produce a dynamic prompt list, continue on to the next few sections.