Create a Custom Widget Using an Automation Script - Administrator Guide - 6.10 - Cortex XSOAR - Cortex - Security Operations

Cortex XSOAR Administrator Guide

Cortex XSOAR
Creation date
Last date published
Administrator Guide

Create a custom script based widget in Cortex XSOAR using an Automation Script. Use custom widgets in dashboards and reports.

You can use custom script based widgets with an automation script to create dynamic widgets for more complex calculations. For examples of creating widgets using scripts, see Script Based Widgets Using Automation Scripts Examples.


Cortex XSOAR supports JavaScript, Python and PowerShell.

You need to create or upload the script to the Automation page and then you can create a widget in Widgets Library. In the Widgets Library, you can define the arguments and change the visuals.


If you upload a script to the Automation page, the Arguments field is automatically updated. You can then define the arguments in the Widget Builder. If you create a new automation (without uploading) in the Automation page, you need to add the arguments manually for them to appear in the Widgets Library when creating or editing a widget.

  1. In the Automation page, upload or create a new automation.

    Create the following widgets using automations:

    • Text

    • Number

    • Duration

    • Trend

    • Chart

    • Table or List

    • Filter Data for all Widgets (Pivoting)

    For examples, see Script Based Widgets Using Automation Scripts Examples.

  2. For dashboards and reports, create a widget in the Widgets Library, as described in Create a Widget using the Widget Builder.

  3. Select the Script based data type and then add the script.

    (Upload automation only) If you have added arguments, these appear when creating a widget. If you have not uploaded the automation, you need to add the arguments manually in the Automation page.

  4. Add the script based widget to one of the following: