Create a custom widget using a script - Create a custom script based widget. Use custom widgets in dashboards and reports. - Administrator Guide

Create a custom widget using a script - Create a custom script based widget. Use custom widgets in dashboards and reports. - Administrator Guide - Cortex CLOUD

Cortex Cloud Posture Management Documentation

Product

Cortex Cloud Application Security > Cortex CLOUD

License

Cloud Posture Management

Creation date

2025-01-22

Last date published

2026-06-10

Category

Administrator Guide

Abstract

Create a custom script based widget. Use custom widgets in dashboards and reports.

You can use scripts in custom widgets to create dynamic widgets for more complex calculations and to present data from third-party systems. For examples of creating widgets using scripts, see Script-based widget examples.

Before creating a script-based widget in the Widgets Library, you need to create or upload the script to the Scripts page. In the Widgets Library, you can change elements of the visual presentation. Because these widgets can contain unique logic or sensitive data queries, they are now managed as individual items with specific access rules.

The ability to create and manage script-based widgets is determined by your role permissions and the widget's visibility:

Creation rights: To create a script-based widget, your user role must allow you to create scripts and build dashboards. These permissions are set by your administrator. For more information, see Manage access to custom dashboards.
Widget Library visibility:
- Restricted: New script widgets are Restricted by default. They are only visible to you within the Widget Library.
- Public: If you want other users to be able to find and reuse your script in their own dashboards, the widget must be set to Public.

Create the script: Select Investigation & Response → Automation → Scripts. You can upload an existing script or create a new one. Cortex Cloud supports JavaScript, Python and PowerShell. You can create a script for one of the following chart types:
- Pie
- Column
- Line
- Single Value
Configure for the Widget Library: In the Script Settings, add the widget tag to the script. This tag ensures the script is recognized as a visualization tool and becomes available in the Widget Library.
Create the Custom Script Widget: Select Dashboards & Reports → Widget Library, click Create custom widget, and select Script.
Define the widget properties:
- Name and Description: Give your widget a clear name so you can identify it later in the Widget Library.
- Script: Select the script you created in step 1 from the list.
  Note
  If you have added arguments to the script, these appear when creating a widget.
Set visibility: Use the Public widget toggle to determine how the widget appears in the Widget Library. Leave it unselected (default) to keep the widget Restricted (visible only to you) or select it to make the widget Public (visible to all users with Widget Library access).
Preview and save: Run a preview to ensure the script executes correctly and displays the data as intended, then click Save.
Configure the display (Chart Editor): Use the Chart Editor to choose the graph type and the subtype, and to enable or disable the graph legend.
Note
Available options are Pie, Column, Line, and Single Value.
To display the result of the script as a time duration, choose the graph type Single Value and enable Show as Time. You can then select the Time Unit (millisecond, second, minute, or hour) and the Display format.
Add to reports or dashboards: Once saved to the Widget Library, you can add this script-based widget to any custom dashboard or include it when building a report template.

Note

Note