Add a Script to the Incident Layout - Administrator Guide - 6.10 - Cortex XSOAR - Cortex - Security Operations

Cortex XSOAR Administrator Guide

Cortex XSOAR
Creation date
Last date published
Administrator Guide

Add automation script-based content to an incident layout in Cortex XSOAR, using the General Purpose Dynamic section.

You can add automation script-based content to the incident layout by adding the General Purpose Dynamic Section in the incident layout builder.

The General Purpose Dynamic Section enables you to configure a section in the incident layout from an automation script. The automation can return a simple text, markdown, or an HTML, the results of which appear in General Purpose Dynamic Section. All possible values for EntryFormat are specified in CommonServerPython.

You can add any required information from an automation. For example, you can assign a script that calculates the total number of entries that exist for an incident, and it dynamically updates when new entries are added to the incident. You can also Add a Custom Widget to the Incident Page and Add Note Information Using an Automation Script.

The following are examples of values that can be returned from the General Purpose Dynamic Section script:

Text Example


Markdown Example

    'ContentsFormat': EntryFormat.MARKDOWN,
    'Type': EntryType.NOTE,
    'Contents': <MARKDOWN_DATA>

HTML Example

    'ContentsFormat': EntryFormat.HTML,
    'Type': EntryType.NOTE,
    'Contents': <HTML_DATA>

Before you begin, you need to create an automation script.

  1. Select the layout you want to add to the General Purpose Dynamic Section by completing steps 1 to 3 in Customize Incident Layouts.

  2. Drag and drop the General Purpose Dynamic Section into the layout area you want to appear.

  3. Select the General Purpose Dynamic Section, click indicator-option-pointer.png and then click Edit section settings.

  4. In the Name and Description fields, add a meaningful name and a description for the dynamic section that explains what the script displays.

  5. In the Automation script field, from the drop down list, select the script that returns data for the dynamic section.


    Only automations to which you have added the dynamic-section tag appear in the drop down list.

  6. Click OK.