Professional

Adding custom columns in Burp Logger

  • Last updated: July 17, 2025

  • Read time: 3 Minutes

You can use Java-based scripts to add powerful custom columns to the Burp Logger table. Custom columns enable you to see more detail about the items that have been logged 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, see Importing 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 or Cmd + S

  • Save as - Ctrl + Shift + S or Cmd + Shift + S

  • Create new script - Ctrl + N or Cmd + N

  • Load recent script - Ctrl + O or Cmd + O

Loading scripts from your library

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

To load a script from your Bambda library:

  1. In Logger, click the options menu > Add custom column. The Add custom column window opens.

  2. Click Load.

  3. Select a recent script from the list.

  4. If the script you want to load isn't in the list, click View 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. Click Apply to compile and test the script. Fix any errors shown in the Compilation errors panel. For more information, see Troubleshooting scripts.

    3. Save your changes:

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

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

  6. Enter a name for your column in the Column header field.

  7. Click Apply & close.

Creating custom scripts

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

Note

Before you begin writing, we recommend exploring our Bambdas GitHub repository. There may be an existing script that meets your needs or provides inspiration for creating your own.

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

  • LoggerHttpRequestResponse

  • Utilities

To create a custom column for your Logger table:

  1. In Logger, click the options menu > Add custom column. The Add custom column window opens.

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

  3. Enter a name for your column in the Column header field.

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

  5. Click Apply to compile and test the script. Fix any errors shown in the Compilation errors panel. For more information, see Troubleshooting scripts.

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

  7. Click Apply & close.

Warning

Using slow running or resource-intensive scripts can slow down Burp. Write your script carefully to minimize performance impact.

Example script

In the example below, we'll write a script to create a custom column containing the Server header value of the response.

if (!requestResponse.hasResponse()) { return ""; } var response = requestResponse.response(); return response.hasHeader("Server") ? response.headerValue("Server") : "";

Related pages