---
id: robotframework-reportportal
version: "5.7.1"
license: unclear
license_treatment: unclear
maintenance: active
---

# robotframework-reportportal — Agent for reporting RobotFramework test results to ReportPortal

License: unclear · Maintenance: active · Downloads: 104.0K/mo

## What it is and what it does

This package is a RobotFramework listener that integrates test execution with ReportPortal, a test reporting and analytics platform. It captures test results, logs, and metadata from RobotFramework runs and sends them to a ReportPortal instance for centralized reporting, analysis, and team visibility. The listener supports both synchronous and asynchronous reporting modes, configurable timeouts, batch logging, and attachment uploads (such as screenshots or HTML reports).

You configure it by passing command-line variables to the robot command, specifying your ReportPortal endpoint, project, launch name, and authentication credentials (either an API key or OAuth 2.0 parameters). It also provides a custom logger for use in Python keywords that supports attaching files to log entries. The package supports test case IDs via tags, rerun modes, and options to flatten or remove keywords from reporting.

Use it for:

- Send RobotFramework test results to a centralized ReportPortal dashboard for team visibility and trend analysis.
- Attach screenshots and logs to test results for easier debugging and failure investigation.
- Configure rerun modes to track and report on test reruns separately from initial runs.
- Use async batch reporting to reduce overhead on large test suites while maintaining result accuracy.
- Tag tests with case IDs to link RobotFramework execution to external test management systems.

## Worth the install?

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

A RobotFramework listener that sends test execution results to ReportPortal, supporting both API key and OAuth 2.0 authentication with configurable reporting options.

Yes, if you run RobotFramework tests and have a ReportPortal instance. The package is actively maintained, has low install friction, and integrates cleanly via a listener. Verify the license declaration in the repository first, and confirm that the Google Analytics integration aligns with your organization's data policies.

## Install

pip install robotframework-reportportal
uv add robotframework-reportportal
poetry add robotframework-reportportal

## Installing robotframework-reportportal

Before you install: Low install friction with a single runtime dependency (reportportal-client). Package is actively maintained with recent releases and a stable release cycle.

License in practice: License treatment is unclear—the description references Apache 2.0 but the metadata does not declare it formally. Verify the actual license in the repository before use in proprietary or restricted contexts.

Quickstart:

pip install robotframework-reportportal

robot --listener robotframework_reportportal.listener \
  --variable RP_ENDPOINT:"https://reportportal.example.com" \
  --variable RP_LAUNCH:"my_launch" \
  --variable RP_PROJECT:"my_project" \
  --variable RP_API_KEY:"your_api_key" \
  tests/

RobotFramework must be installed separately; ReportPortal server endpoint and valid credentials (API key or OAuth 2.0) are required.

Verify before relying:

- Whether the Google Analytics integration can be disabled or opted out of without code changes.
- Performance impact of async batch reporting modes on large test suites.
- Compatibility with ReportPortal server versions and backward compatibility guarantees.

## Package facts

- License: not declared (unclear)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 104.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

robot framework test reporting, reportportal integration, test results to reportportal, robot framework listener, automated test reporting, test execution dashboard, qa test results portal, test-reporting, robot-framework, qa-integration

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