pytest-html

Visit Website

Introduction

pytest-html is a plugin for pytest that generates an HTML report for test results, according to its README. It is maintained in the pytest-dev organisation and published on PyPI and conda-forge.

Running pytest with --html=report.html produces a report with a summary, environment information, and a table of results that can be filtered and sorted. Hooks let you add extras such as images, links, text or HTML to individual tests, add or change columns, and modify the summary and environment sections. A self-contained option embeds assets into a single file for easy sharing as a CI artifact.

The 4.x line is current, with release 4.2.0 in January 2026.

In the quality loop it supports release reviews with a simple, shareable report.

The source code is at pytest-dev/pytest-html on GitHub under the MPL-2.0 licence, with about 780 stars; the most recent commit was on 10 August 2026.

Features

1. HTML report: Summary and results table.
2. Extras: Images, links and HTML per test.
3. Customisation hooks: Columns, summary and environment.
4. Self-contained mode: Single-file report.
5. pytest-dev maintained: Part of the pytest ecosystem.

Pros

1. Zero-config: One command-line flag.
2. Free to use: Open source under the MPL-2.0 licence, so the core tool costs nothing to use.
3. Actively maintained: The repository had commits as recent as 10 August 2026.

Cons

1. Single run: No history or trends.
2. Basic visuals: Less rich than Allure.

Usage and Links (Example)

pip install pytest-html
pytest --html=report.html --self-contained-html

Resources:

• pytest-html website
• GitHub repository

Pricing

pytest-html is free and open source under the MPL-2.0 licence.

Recommended for?

1. pytest users wanting a quick shareable report.
2. Not a fit for cross-run analytics.

Conclusion

pytest-html is the simplest way to get an HTML report from pytest.

On CheckOps, pytest-html is filed under the Release & CI gates stage. Related tools listed here include pytest, Allure Report, ReportPortal, mochawesome, Monocart Reporter and TestBeats. Before choosing, compare them on licence, supported languages and platforms, hosting model, and how well each fits your existing CI pipeline. Facts on this page were checked against the official website, documentation and repository on 11 November 2026; statements the vendor makes about its own product are marked as vendor claims.