Create a word cloud visualization for a text widget

To visualize any patterns in user-entered text in an indicator, use a word cloud visualization in a text widget.

Before you begin

Text indexing must be configured for the relevant indicator source, and this configuration must include the relevant indicator.

Text analytics is available only with the licensed version of Performance Analytics.

Role required: pa_power_user or admin

About this task

The Text widget provides a word cloud for visualizing the frequency of words and phrases.
Figure 1. Word cloud visualization - text widget
Word cloud of text from open incidents, top half

To drill down in the analysis by a keyword, the user left-clicks a word in the cloud. The analysis runs again, looking for words that appear with that keyword. The user can select additional keywords to drill down further. You can select a set of keywords for a default drilldown that appears for all users when they view the widget in a dashboard.

Figure 2. Word cloud drilled down by keyword 'access'
Word cloud of text from open incidents, bottom half


  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 Text.
    If you change the value of Type after you fill in other fields, those fields are cleared.
    Word Cloud is automatically selected as the Visualization.
  4. In the Indicator field, select the main indicator for which you want to analyze text.
  5. (Optional) Fill in any of the following fields:
    Breakdown and Element Only text that is associated with the specified element of the specified breakdown is analyzed. Select values for both Breakdown and Element. Otherwise, only text that is not associated with any element of the breakdown is shown.
    2nd Breakdown and Element Drill down to a second level of breakdown and element, if a first-level breakdown and element have been specified.
    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 second breakdown and element on the widget.

  6. (Optional) Set any of the display settings.
    Default field If multiple fields are selected in the text index configuration, this field appears by default.
    Cut-off Minimum number of occurrences of a word for it to be included in the cloud.
    Limit Maximum number of words to show.
  7. Click Submit.

What to do next

  • Add the widget to a dashboard.
  • Text analysis uses special steps in the data collection job. If no data is available for the widget, verify that the relevant data collection job has run and that the job collects text indexes. See Collect initial text analytics data.