Creating BChecks

  • Last updated: September 21, 2023

  • 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.


You can share your BChecks and download new ones via the BChecks GitHub repository. This includes example checks created by PortSwigger, as well as BChecks developed by the Burp Suite community.

For information on contributing to the BChecks repository, see the Contributing readme page.

To create a BCheck in Burp:

  1. Go to Extensions > BChecks.
  2. Click New. 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. 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.


You can Save & close a BCheck that contains errors. The BCheck is added to the table, but can't be enabled. To enable the BCheck, first fix any errors in the definition.

Related pages

Was this article helpful?