Thank you for your feedback.
Form temporarily unavailable. Please try again or contact to submit your comments.
  • London
  • Kingston
  • Jakarta
  • Istanbul
  • Helsinki
  • Geneva
  • Store

Create a treemap visualization for a breakdown widget

Create a treemap visualization for a breakdown widget

To display a hierarchy of breakdown elements, use a treemap visualization.

Before you begin

Role required: pa_power-user or admin

About this task

If the elements of a breakdown differ in favorability, or if you want to compare each breakdown element against an indicator target, you can use a treemap. Treemaps use nested rectangles with the size representing the relative proportion of the element and the color representing the favorability.
Figure 1. Treemap visualization
Treemap visualization of open incidents by Priority, with the deeper blue indicating the higher priority


  1. Navigate to Performance Analytics > Widgets and click New.
  2. In the Name field, give the widget a name that reflects the information being displayed.
  3. In the Type field, select Breakdown.
    If you change the value of Type after you fill in other fields, those fields are cleared.
  4. In the Visualization field, select Treemap.
    You can let the user switch between visualizations. Select Show visualization selector in the Display settings tab.
  5. In the Indicator field, select the main indicator which you want to break down.
  6. (Optional) To show only the scores that match one element of a breakdown, select a filtering breakdown in the Breakdown and Element fields.
    To use a breakdown to filter the data, you must specify an element.
  7. Select the breakdown to group the scores by.
    • If you did not select a breakdown as a filter, select the grouping breakdown in the Breakdown field.
    • If you selected a filtering breakdown in the Breakdown and Element fields, select the grouping breakdown in the 2nd Breakdown field.
    You can let the user switch between breakdowns to apply. Select Show breakdown selector in the Display settings tab.
  8. In the Coloring method field, select whether to rank the favorability based on score, change to score, percent of change, or an indicator target.
  9. Select the color that indicates a positive in the Positive color field.
  10. Depending on the Coloring method, you may need to select a Negative color
  11. (Optional) Fill in any of the following fields:
    Time series Run a function on the scores for a specific time period, such as applying a 7-day sum or average. For more information, see ../reference/time-series-in-scorecards-widgets.html#time-series-aggregations-in-scorecards-and-widgets.
    Sort on Sort the data on this attribute.
    Follow element Applies only when this widget is placed in a "breakdown dashboard." Select this option for the widget to follow the element that the user selects interactively on the dashboard. See Using breakdowns on dashboards.

    Selecting this option removes the ability to set a filtering option on the widget. Only one Breakdown field remains in the form, for selecting the grouping breakdown.

    Follow breakdown Breakdown dashboard configurations specify breakdown sources, not specific breakdowns. The same breakdown source can be used for multiple breakdowns. Therefore, select this option to set which of the possible breakdowns to follow.

    For example, consider the indicator Number of open incidents. This indicator uses two breakdowns: Assigned to, and Created by. Both breakdowns are based on the Users.Active breakdown source. You create a widget for this indicator and you select Follow element on this widget. You also need to select Follow breakdown and specify either the Assigned to or the Created by breakdown.

    This option is available only if Follow element is selected.

  12. (Optional) Review the Settings tabs and change settings as desired.
  13. Click Submit.

What to do next

To view the widget, add it to a dashboard.

Updates to site content will be made starting around 4am on January 17th (Pacific Time) and lasting approximately 6 hours.  This site may be intermittently unavailable.