Professional

Adding custom columns in the WebSockets history

• Last updated:November 18, 2025

• Read time:3 Minutes

You can use Java-based scripts to add powerful custom columns to the WebSockets history table. Custom columns enable you to see more detail about the items in your WebSockets history for a more focused analysis.

You can apply custom column scripts in two ways:

• Load existing scripts - Load scripts from your Bambda library. This is your personal collection of reusable scripts. It includes any scripts you've created and saved, or ones you've imported, for example, from our GitHub repo. For more information, seeImporting scripts.

• Create new scripts - Write your own custom scripts. To get started quickly, use one of the built-in templates. These work out of the box and are easy to customize.

Keyboard shortcuts

To speed up your workflow when creating or loading scripts, you can use the following keyboard shortcuts:

• Save -Ctrl + S orCmd + S

• Save as -Ctrl + Shift + S orCmd + Shift + S

• Create new script -Ctrl + N orCmd + N

• Load recent script -Ctrl + O orCmd + O

Loading scripts from your library

You can load and apply scripts that are stored in your library to add custom columns to the WebSockets history table.

To load a script from your Bambda library:

1. InProxy > WebSockets history, click the options menu > Add custom column. TheAdd custom column window opens.

2. ClickLoad.

3. Select a recent script from the list.

4. If the script you want to load isn't in the list, clickView all to view all scripts stored in your library.

   1. Select a script.
   2. Click Load.

5. [Optional] If required, edit the script:

   1. Make your changes.

   2. ClickApply to compile and test the script. Fix any errors shown in theCompilation errors panel. For more information, seeTroubleshooting scripts.

   3. Save your changes:

      • To overwrite the existing script, clickSave to library > Save.

      • To save a new version, clickSave to library > Save as.

6. Enter a name for your column in theColumn header field.

7. ClickApply & close.

Creating custom scripts

You can write your own scripts directly in theAdd custom column window, using built-in templates or from a blank definition.

Two objects of the Montoya API are available to help you write your script:

• ProxyWebSocketMessage

• Utilities

To create a custom column for your WebSockets history table:

1. InProxy > WebSockets history, click the options menu > Add custom column. TheAdd custom column window opens.

2. If you want to create your script from a built-in template, selectNew > From template. Select a template from the list, then clickCreate using this template.

3. Enter a name for your column in theColumn header field.

4. Write a script using Java to specify the data that the custom column displays.

5. ClickApply to compile and test the script. Fix any errors shown in theCompilation errors panel. For more information, seeTroubleshooting scripts.

6. [Optional] ClickSave to library > Save. The script is saved to your Bambda library for future use across Burp.

7. ClickApply & close.

Example script

In the example below, we'll write a script to create a custom column containing thesession ID of the response.