Professional
Adding custom columns in the HTTP history
-
Last updated: February 13, 2025
-
Read time: 3 Minutes
You can use Java-based Bambdas to add powerful custom columns to the HTTP history table. Custom columns enable you to see more detail about the items in your HTTP history for a more focused analysis.
You can apply custom column Bambdas in two ways:
-
Load existing Bambdas - Load Bambdas from your Bambda library.
-
Create new Bambdas - Write and apply Bambdas directly in the Add custom column window.
Related pages
- For more information on how to manage your Bambdas, see Managing Bambdas in your Bambda library.
- For more information on how to add Bambdas to your library for use across Burp, see Importing Bambdas into your Bambda library.
Keyboard shortcuts
To speed up your workflow when creating or loading Bambdas, you can use the following keyboard shortcuts:
Save -
Ctrl + S
orCmd + S
Save as -
Ctrl + Shift + S
orCmd + Shift + S
Create new Bambda -
Ctrl + N
orCmd + N
Load recent Bambda -
Ctrl + O
orCmd + O
Loading Bambdas from your library
You can load and apply Bambdas that are stored in your library to add custom columns to the HTTP history table.
To load a Bambda from your library:
In Proxy > HTTP history, click the options menu > Add custom column. The Add custom column window opens.
-
Click Load.
-
Select a recent Bambda from the list.
-
[Optional] If required, edit the Bambda:
Make your changes.
Click Apply to compile and test the Bambda. Fix any errors shown in the Compilation errors panel. For more information, see Troubleshooting Bambdas.
-
Save your changes:
To overwrite the existing Bambda, click Save > Save.
To save a new version, click Save > Save as.
Enter a name for your column in the Column header field.
Click Apply & close.
Creating custom Bambdas
You can write your own Bambdas directly in the Add custom column window.
Note
Before you begin writing, we recommend exploring our Bambdas GitHub repository. There may be an existing Bambda that meets your needs or provides inspiration for creating your own.
You can also explore built-in templates in the Bambda library. For more information, see Creating Bambdas in the Bambda library.
Two objects of the Montoya API are available to help you write your Bambda:
ProxyHttpRequestResponse
Utilities
To create a custom column for your HTTP history table:
In Proxy > HTTP history, click the options menu > Add custom column. The Add custom column window opens.
Enter a name for your column in the Column header field.
-
Write a Bambda using Java to specify the data that the custom column displays.
-
Click Apply to compile and test the Bambda. Fix any errors shown in the Compilation errors panel. For more information, see Troubleshooting Bambdas.
-
[Optional] Click Save > Save. The Bambda is saved to your Bambda library for future use across Burp.
-
Click Apply & close.
Warning
Using slow running or resource-intensive Bambdas can slow down Burp. Write your Bambda carefully to minimize performance impact.
Example Bambda
In the example below, we'll write a Bambda 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
- To get feedback, showcase your work, and connect with other Bambda developers, share your Bambda on our PortSwigger Discord #bambdas channel.
- To share your Bambdas with the community, add them to our ever-growing Bambdas GitHub repository. For more information, see Submitting Bambdas to our GitHub repository.