---
id: allure-robotframework
version: "2.16.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# allure-robotframework — Allure Robot Framework integration

License: permissive · Maintenance: active · Downloads: 148.6K/mo

## What it is and what it does

allure-robotframework is a listener plugin that connects Robot Framework test execution to Allure Report, a test reporting platform. When you run Robot Framework tests with this listener enabled, it captures test results, steps, attachments, and metadata, then generates a structured report that Allure can render into an interactive HTML dashboard. The listener runs as a Robot Framework plugin and outputs results to a configurable directory (default: output/allure), which you then feed to Allure's report generator.

The package depends only on allure-python-commons and installs as a wheel with low friction. It supports both sequential test execution and parallel runs via robotframework-pabot. You configure it by passing it to Robot Framework's --listener flag, optionally specifying an output path. An advanced setting (ALLURE_MAX_STEP_MESSAGE_COUNT) lets you control whether individual messages within a step appear as substeps or attachments, useful for managing report size in large projects.

Use it for:

- Generate detailed Allure reports from Robot Framework test suites to visualize test execution history and trends.
- Integrate Robot Framework tests into CI/CD pipelines that consume Allure reports for test dashboards.
- Capture test steps and attachments (logs, screenshots) automatically during Robot Framework execution.
- Run parallel tests with pabot while collecting results into a single Allure report.
- Reduce report bloat in large test projects by controlling how many step messages appear as substeps.

## Worth the install?

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

Integrates Robot Framework test execution with Allure Report, capturing test results and generating detailed HTML reports with steps, attachments, and test history.

Yes. The package is production-stable, actively maintained, has no known vulnerabilities, and installs with minimal friction. It directly solves the problem of integrating Robot Framework tests with Allure Report. Install it if you use Robot Framework and want rich, interactive test reporting; skip it only if you have no need for Allure's reporting features.

## Install

pip install allure-robotframework
uv add allure-robotframework
poetry add allure-robotframework

## Installing allure-robotframework

Before you install: Low install friction with a single runtime dependency (allure-python-commons). Active maintenance with recent releases and 813 repository stars indicate ongoing support.

License in practice: Apache-2.0 permissive license allows use in commercial and open-source projects with minimal restrictions; you must include a copy of the license and note any modifications.

Quickstart:

pip install allure-robotframework
robot --listener allure_robotframework ./my_robot_test
# Or with custom output path:
robot --listener allure_robotframework:/custom/path ./my_robot_test

Verify before relying:

- Whether the listener works with Robot Framework versions prior to 3.x or has specific framework version requirements.
- Performance impact when processing large test suites with the ALLURE_MAX_STEP_MESSAGE_COUNT setting.
- Compatibility details with robotframework-pabot for parallel execution across different pabot versions.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 148.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

robot framework test reporting, allure report integration, robot framework listener, test results visualization, automated test reporting, robot framework html reports, allure test adapter, test-reporting, robot-framework, allure

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