---
id: robotframework-retryfailed
version: "0.2.0"
license: unclear
license_treatment: permissive
maintenance: aging
---

# robotframework-retryfailed — A listener to automatically retry tests or tasks based on flags.

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

## What it is and what it does

robotframework-retryfailed is a listener plugin for Robot Framework that intercepts test failures and automatically reruns them based on retry configuration. You attach it to your test execution via command-line arguments and control retry behavior either globally (by passing a retry count to the listener) or per-test (by tagging individual tests with `test:retry(N)` or `task:retry(N)` to specify how many times they should be retried on failure).

The package is minimal and focused: it depends only on robotframework itself and requires Python 3.8 or later. It is useful for handling flaky tests in continuous integration or local test runs without modifying test code. However, the package has not been updated since its initial release in October 2022, so you should verify compatibility with your current Robot Framework version before adopting it.

Use it for:

- Automatically retry flaky integration tests in CI pipelines without modifying test code.
- Tag specific tests with `test:retry(3)` to retry them up to 3 times on failure.
- Set a global retry count via `--listener RetryFailed:2` to retry all failing tests uniformly.
- Handle transient failures in acceptance tests caused by timing or external service issues.
- Reduce false negatives in test suites by distinguishing between real failures and intermittent flakes.

## Worth the install?

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

A Robot Framework listener that automatically retries failed tests or tasks based on tags or a global retry count parameter.

Yes, if your Robot Framework version is compatible and you need automatic retry logic without modifying test code. The low install friction and permissive license make it a low-risk addition. However, the lack of updates since October 2022 is a concern—verify that it works with your current Robot Framework version before committing to it in production.

## Install

pip install robotframework-retryfailed
uv add robotframework-retryfailed
poetry add robotframework-retryfailed

## Installing robotframework-retryfailed

Before you install: Low install friction with a single runtime dependency on robotframework. The package is aging—last release was in October 2022 with no updates since—but the repository remains active and unarchived as of December 2025.

License in practice: Licensed under Apache Software License (permissive), which allows use, modification, and distribution with minimal restrictions.

Quickstart:

pip install robotframework-retryfailed

robot --listener RetryFailed:2

*** Test Cases ***
Test Case
    [Tags]    test:retry(2)
    Log    This test will be retried 2 times if it fails

Requires robotframework to be installed and Python 3.8 or later.

Verify before relying:

- Whether the package works with Robot Framework versions released after October 2022.
- Current compatibility with Python 3.10, 3.11, or 3.12 despite classifiers listing only 3.8 and 3.9.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 483.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

robot framework retry failed tests, test retry listener, automatic test retry, robot framework flaky test handling, retry on failure robot, test retry tags, robot framework resilience, robot-framework, test-resilience, flaky-test-handling

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