Create a Custom Widget

Required Tenable Vulnerability Management User Role: Basic, Scan Operator, Standard, Scan Manager, or Administrator

You can use the custom widget option to create uniquely defined widgets, which you can then add to any user-defined dashboards.

To create a custom widget:

  1. Do one of the following:
    • Create a custom widget via the widget library:
      1. View the widget library.
      2. In the upper-right corner of the page, click the Custom Widget button.

        The Create Custom Widget page appears.

    • Create a custom widget while editing a dashboard:

      1. Edit a dashboard.
      2. In the upper-right corner of the page, click Add Widgets.

        A menu appears.

      3. Click Custom Widget.

    The Create Custom Widget page appears.

  2. In the upper-right corner of the page, click Add Widgets.

    A menu appears.

  3. Click Custom Widget.

    The Widgets page appears.

  4. In the charts section, select the chart type for your custom widget:

    • Table

    • Ring chart (Vulnerabilities dataset only)

    • Bar chart (Vulnerabilities dataset only)

  5. In the dataset drop-down box, select the type of information Tenable Vulnerability Management uses to update the widget:
    • Vulnerabilities
    • Assets

      Note: If you selected ring chart or bar chart in the charts section, selecting the Assets dataset resets the chart selection to a table.

    The chart type, Data Grouping, and Display Fields options update based on your selection.

  6. In the Data Grouping drop-down box, select how you want to group the data:
    • By Plugin (Vulnerabilities dataset only)
    • By Asset (Vulnerabilities dataset only)
    • By CVE (Vulnerabilities dataset only)
    • Asset List (Assets dataset only)
  7. (Optional) To filter the widget data using filters:
    1. Click the button to expand the filter options.
    2. In the drop-down box, select category, operator, and value types.
    3. (Optional) Click the Add button to specify more filters.

    Note: If you previously created a tag, it appears in the custom widget's list of filters.

    Note: If you exceed the current asset query limitation of 5,000, a message appears in your interface. Refine the query to a smaller set of asset tags.

    Note: Tenable Vulnerability Management does not currently support tag filters in exports.

  8. (Optional) To filter the widget data using an existing saved search, in the Saved Searches drop-down box, select the saved search you want to use to filter your widget data.

    Note: If you do not have any saved searches, this option does not appear. To create a new saved search, see Saved Search.

  9. In the Name box, type a name for the custom widget.

    In the Widget Preview, the title updates automatically.

  10. (Optional) In the Description box, type a description for the custom widget.

    In the Widget Preview, the icon appears and the description hover text updates automatically.

  11. Click Update Preview to update the widget preview.

    Note: While Name, Description, and the chart type all update in the widget preview automatically, all other configuration options refresh after you click Update Preview.

  12. Click Save and Exit.

    Tenable Vulnerability Management saves the custom widget to the widget library, and you can add the widget to any user-defined dashboards.