← Back to documentation

HTML reports

HTML reports are powered by @cucumber/html-formatter. They can be enabled using the html.enabled property. The preprocessor uses cosmiconfig, which means you can place configuration options in EG. .cypress-cucumber-preprocessorrc.json or package.json. An example configuration is shown below.

{
  "html": {
    "enabled": true
  }
}

The report is outputted to cucumber-report.html in the project directory, but can be configured through the html.output property.

Screenshots

Screenshots are automatically added to HTML reports, including that of failed tests (unless you have disabled screenshotOnRunFailure). This can be turned off using the attachments.addScreenshots property, which defaults to true.

Videos

Videos are not automatically added to reports, but can be turned on using the attachments.addVideos property. This assumes you've configured Cypress to capture videos. Videos are base-64 encoded and included in the files, which may affect size and performance.

Attachments

Attachments can also be added to HTML reports through an API. This API is further explained in JSON report, but applies to HTML reports as well.