---
id: pytest-html-reporter
version: "0.2.9"
license: MIT
license_treatment: permissive
maintenance: aging
---

# pytest-html-reporter — Generates a static html report based on pytest framework

License: permissive · Maintenance: aging · Downloads: 83.7K/mo

## What it is and what it does

pytest-html-reporter is a pytest plugin that generates static HTML reports from test execution results. It runs as a pytest command-line extension and produces a self-contained HTML file showing test outcomes, execution trends, suite highlights, and detailed test information. The plugin supports attaching screenshots on test failure (useful for UI testing with Selenium), test rerun tracking, and historical report archiving. It has no runtime dependencies and integrates directly into pytest's reporting pipeline via command-line flags or pytest.ini configuration.

The package is straightforward to use: install it, run pytest with `--html-report` to specify output location, and optionally add `--title` to customize the report heading. For screenshot capture, you import the `attach` function and call it with binary image data during test execution. The generated HTML is static and self-contained, suitable for sharing or archiving test results.

Use it for:

- Generate shareable HTML test reports for CI/CD pipelines to track test execution history and trends over time.
- Capture and embed screenshots in test reports when UI tests fail, for debugging and documentation.
- Archive test results with customizable paths and filenames to organize reports by test suite or date.
- Display test suite highlights and overview statistics in a single-page HTML report for stakeholder review.
- Integrate with pytest.ini to standardize report generation across a team's test infrastructure.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Generates static HTML test reports from pytest test runs, with support for test history, screenshots on failure, and customizable report paths and titles.

Yes, with conditions. The package is lightweight, permissively licensed, and solves a real need for pytest users who want HTML reports. However, it has not been updated since 2022-02-13 and is marked as aging; before installing, verify that it works with your current pytest and Python versions. The lack of recent maintenance means unresolved issues may not be fixed.

## Install

pip install pytest-html-reporter
uv add pytest-html-reporter
poetry add pytest-html-reporter

## Installing pytest-html-reporter

Before you install: High install friction; no runtime dependencies but the package has not been updated since 2022-02-13 and maintenance is marked as aging, though the repository remains active.

License in practice: MIT license (permissive) means you can use, modify, and distribute this package freely with minimal restrictions, provided you include the license notice.

Quickstart:

pip install pytest-html-reporter

pytest tests/ --html-report=./report --title='Test Report'

For screenshots on failure:
from pytest_html_reporter import attach
attach(data=self.driver.get_screenshot_as_png())

Verify before relying:

- Whether the package works reliably with pytest versions released after 2022-02-13
- Compatibility with modern Python versions beyond the stated >=3.5 requirement
- Whether the aging maintenance status indicates unresolved bugs or compatibility issues

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: high
- Maintenance: aging
- Downloads: 83.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pytest html report generator, test report html output, pytest test results visualization, html test reporter, pytest report with screenshots, test execution report html, pytest test history tracking, pytest-plugin, test-reporting, html-output

[View on SkillFed](https://skillfed.io/packages/pytest-html-reporter) · [View on PyPI](https://pypi.org/project/pytest-html-reporter/)