Creating BChecks

  • Last updated: July 6, 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.

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?