Professional

Creating BChecks

• Last updated: April 29, 2025

• Read time: 2 Minutes

You can define BChecks yourself, using our custom definition language. This enables you to target your scans and make your testing workflow as efficient as possible.

When you create a BCheck in Burp, you can work from a range of example definitions. Each definition describes a functional BCheck. Edit these to create new BChecks that meet your requirements.

To create a BCheck from an example definition:

1. Go to Extensions > BChecks.
2. Click New > From template. The New BCheck dialog opens, which contains various example BCheck definitions.
3. Select an example BCheck definition, then click Create using this template. The BS Code editor opens.
4. Edit the BCheck to meet your requirements.
5. Click Validate. Burp identifies any errors in the BCheck.
6. Fix any errors in the BCheck.
7. To automatically standardize the indentation and whitespace, right-click the editor and select Format BCheck. You can undo the changes with Cmd+Z or Ctrl+Z if you prefer your original layout.

8. Save the BCheck:

   • To save the BCheck and close the BS Code editor, click Save & close. The BCheck is added to the table and enabled by default. Burp Scanner will use it when you perform an audit.
   • To save and enable the BCheck without closing the BS Code editor, click Save. You can then test the check with Burp Scanner and make changes directly to the definition.

Exporting BChecks

You can export BChecks so that you can import them into other instances of Burp. To export a BCheck:

1. Select the BCheck and click Export .
2. If necessary, select a directory. Click Open to see the contents of the directory.
3. Enter a filename and click Save.

You can select and export more than one BCheck at a time. If you choose this option, the BChecks are exported with their current name.