What is a widget?

Dashboards and reports contain widgets that present data in interactive charts. 

Roll over a chart to obtain more information about an item, click it and select one of the following:

  • View Logs to see its associated logs. See Viewing Web Logs, for example.
    Note that the View Logs option is not available for charts that display secure browsing class, data or status, because they only use samples as their data units.
  • Analyze Chart to view the chart in an Insights page, and then drill down to the logs. See Analyzing Traffic Using Insights.

Screenshot of View Logs and Analyze Chart options for Zscaler widget chart

A widget displays the top five items and groups everything else under Other. You can then click Show Details to see the items that were grouped under Other.

Screenshot of Other slice from Zscaler widget pie chart

When you edit a widget in a dashboard or report, or analyze a chart in Web InsightsMobile InsightsFirewall Insights, or DNS Insights, you can choose any of the following charts to display data:

Screenshot of chart types for Zscaler widgets

Following are some guidelines on using charts:

  • Use line charts to view trends such as bandwidth usage trends.
  • Pie and line charts display the top five results and Other, which is the cumulative total of the remaining results. You can click Other and Show Details to list the additional items grouped under Other.
  • Bar charts and tables display the top 100 results and the remaining results are grouped under Other.
  • On a dashboard or report, administrators can resize widgets that contain a table, a bar chart or a line chart. Widgets with pie charts cannot be resized.
  • Data in charts are aggregated based on the local time of the administrator except for trend charts. For example, data for Current Day will be summarized from 12 a.m. to 11:59 p.m. local time for the administrator viewing the report.
  • Bar charts and tables support the ability to view the top 5, 10, 25, 50 or 100 items. The menu that lists these options (Top 5Top 10Top 25Top 50, and Top 100) appears when you view a bar chart or table in Analytics > Web Insights.


To create a new widget, follow the instructions below.

  1. Do one of the following: 
  • If you are adding a widget to a dashboard, click the Add Widget icon. A dashboard can contain up to 12 widgets.

Screenshot of Add Widget icon on Zscaler dashboards


  • If you are adding a widget to a custom report, click the Add Widget. A report can display up to 20 widgets.

Screenshot of Add Widget icon on custom Zscaler reports

  1. In the Widget Settings dialog, define the following settings: 
    • If you are creating a dashboard widget, specify which type of data the widget displays. Click WebMobile, Firewall, or DNS at the top of the dialog. (The available options depend on your organization's subscriptions.)
    • Title: Type a title, up to 50 characters, for the widget.  
    • Data Type: From the dropdown menu, choose the type of data that the widget displays. You can refine the data by applying filters. For more information on selecting data types and filters, see Web Data Types and FiltersMobile Data Types and FiltersFirewall Data Types and Filters, or DNS Data Types and Filters.
    • Units: From the dropdown menu, choose Transactions or Bytes as the unit of data. Samples are used only with the Secure Browsing Class, Secure Browsing Status or Secure Browsing Type data types.
    • If you are creating or editing a report widget and selected Allow time to be set individually for each widget on the left pane, choose a time frame for the widget.
    • Select a chart type. To learn more, see Using Charts in Widgets in the section above. 
  2. Click OK to add your widget.


To edit or delete a widget, hover over the title of the widget and click the icon that appears in the right-hand corner. 

  • To edit a widget, click Edit Widget and change its settings. After you complete your changes, click OK to apply your changes.
  • To delete a widget, click Remove. Note that you cannot restore a widget after you delete it.

Screenshot of Edit Widget or Remove icon for Zscaler widgets


To move or resize a widget, follow the instructions below.

  • To move a widget, click the title of the widget to drag it to its new location. The adjacent widgets automatically move, therefore the widgets do not overlap when you drag them to their new locations.
  • To resize a widget, click the icon on the lower right-hand corner of a widget and drag to resize the widget. You can resize widgets within a dashboard, which has a fixed resolution of 1024 x 768. You can resize widgets that contain a table, a bar chart or a line chart. Widgets with pie or number charts cannot be resized. Note that the size options of the widgets are fixed. If you enlarge a widget, the adjacent widget automatically moves to prevent overlapping. 

Screenshot of resize icon for Zscaler widgets