Manage your Widget Library - Create, search, and view custom widgets in Cortex XSIAM, or use predefined widgets. - Administrator Guide - Cortex XSIAM - Cortex

Manage your Widget Library - Create, search, and view custom widgets in Cortex XSIAM, or use predefined widgets. - Administrator Guide - Cortex XSIAM - Cortex - Security Operations

Cortex XSIAM 3.x Documentation

Product

Cortex XSIAM

Creation date

2025-07-15

Last date published

2026-06-04

Category

Administrator Guide

Abstract

Create, search, and view custom widgets in Cortex XSIAM, or use predefined widgets.

The Widget Library is the central repository where you can view, create, and manage all predefined and custom widgets. All of your predefined and custom widgets are available in the Widget Library under Dashboards & Reports → Widget Library.

The Widget Library displays predefined widgets, user-created custom Cortex Query Language (XQL) widgets, and user-created custom script widgets.

From the Widget Library, you can select widgets to add to your dashboards or reports, or use existing widgets as templates for new ones. You can search for a widget by name, and use the filter to view only specific widget types. For example, you can filter for all widgets that use a certain chart type, or only view custom widgets you have created.

Your ability to see and use widgets in the Widget Library is based on your user permissions and the visibility status of the widget:

Public widgets: These include all predefined system widgets and any custom widgets that have been marked as Public. These widgets are visible to all users in the Widget Library who have the appropriate permissions to view dashboards and widgets.
Restricted widgets: These are custom widgets that are visible only to the Owner (the creator) within the Widget Library.
Note
Unlike dashboards, individual widgets cannot be shared with other users directly from the Widget Library. Yet, if you add a Restricted widget to a dashboard and then share that dashboard, other users who have access to the dashboard will also be able to see that specific widget.

From the Widget Library you can take the following actions:

Create custom widgets based on XQL search queries: Build new widgets from scratch using Cortex Query Language (XQL). By default, all new custom widgets you create are Restricted and visible only to you. For more information see Create custom XQL widgets.
Create custom widgets based on scripts: Build complex widgets using custom scripts. By default, all new custom widgets you create are Restricted. For more information, see Create a custom widget using a script.
Search for custom and predefined widgets: Widgets are grouped by category for easier discovery.
Edit or delete custom widgets: You can modify or remove custom widgets that you own.
Note
Any dashboards or reports that include the widget are affected by the changes.
Manage visibility: If you are the Owner of a custom widget, you can change its status from Restricted to Public. This makes the widget available in the Widget Library for all other users who have the required permissions. For more information, see Manage access to custom dashboards.

Note

Note