Cucumber HTML logo

Cucumber HTML

Open Source

Built-in HTML report formatter included with Cucumber for visualising BDD test execution results.

Visit website

Pricing

Free / Open source

Type

Automation

Languages

JavaScript, TypeScript, Java, Ruby

// VERDICT

Reach for the Cucumber HTML reporter when you want a simple, built-in report of your Gherkin scenarios straight from a Cucumber run. Skip it when you want richer history/analytics (MasterThought/Allure) or a reporting platform.

Best for

The built-in HTML reporter/formatter for Cucumber - generating a self-contained report of Gherkin scenarios and their results directly from a Cucumber run, with no extra tooling.

Avoid when

You want richer analytics/history, framework-agnostic reporting (Allure), or a reporting platform.

CI/CD fit

Built-in Cucumber formatter · HTML output · CI artifact

Languages

JavaScript · TypeScript · Java · Ruby

Team fit

Cucumber/BDD teams · Teams wanting zero-extra-tooling reports · Quick scenario reports

Setup

Easy

Maintenance

Low

Learning

Beginner

Licence

Free / Open source

// BEST FOR

  • Built-in HTML report of Gherkin scenarios
  • No extra tooling beyond Cucumber
  • Self-contained, shareable scenario results
  • Showing step-level pass/fail
  • Quick setup via the formatter option
  • Living documentation of BDD runs

// AVOID WHEN

  • You want rich analytics and history (MasterThought)
  • Framework-agnostic reporting is needed (Allure)
  • A reporting platform is preferred
  • Cross-framework aggregation matters
  • Trend graphs across runs are required
  • Deep customisation is needed

// QUICK START

Enable the Cucumber HTML formatter (e.g. plugin = "html:target/report.html") ->
run Cucumber -> publish the generated HTML report as a CI artifact.

// ALTERNATIVES TO CONSIDER

ToolChoose it when
MasterThought (Cucumber Reporting)You want richer Cucumber reports with history and trends.
Allure ReportYou want framework-agnostic interactive reports.
Serenity BDDYou want BDD with living-documentation reporting built in.

// FEATURES

  • Single self-contained HTML file with feature/scenario hierarchy
  • Step-level pass/fail status and timing
  • Embeds screenshots, logs, and arbitrary attachments
  • Bundled with Cucumber implementations — no extra dependency
  • JSON and JUnit XML formatters available alongside HTML

// PROS

  • Zero install — comes with Cucumber out of the box
  • Sufficient for small projects without dedicated reporting needs
  • Self-contained file convenient for CI artifacts
  • Stable and consistent across Cucumber language implementations

// CONS

  • Plain compared to Allure or MasterThought reports
  • No trends or cross-build aggregation
  • Limited customisation — accept the defaults or roll your own

// EXAMPLE QA WORKFLOW

  1. Enable the Cucumber HTML formatter

  2. Run Cucumber scenarios

  3. Generate the self-contained HTML report

  4. Publish as a CI artifact

  5. Share as living documentation

  6. Add a richer reporter if you need history

// RELATED QA.CODES RESOURCES

Cheat sheets

Glossary