> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# retry

- **Type:** `number`
- **Default:** `0`
- **CLI:** `--retry <times>`

Retry the test specific number of times if it fails. This is useful for some flaky or non-deterministic test failures.

A single test can override this with [`TestOptions.retry`](/api/runtime-api/test-api/test.md#testoptions), including `{ retry: 0 }` to disable retries for one test even when this config is set.

## Example

You can get two retries by setting `retry:2` when the test fails:


**CLI**

```bash
npx rstest --retry 2
```


**rstest.config.ts**

```ts
import { defineConfig } from '@rstest/core';

export default defineConfig({
  retry: 2,
});
```


When the test has retried, you may get the following logs:

- success:

```bash
 ✓ retry.test.ts (1)
  ✓ should run success with retry (6ms) (retry x2)

 Test Files 1 passed
      Tests 1 passed
   Duration 146 ms (build 22 ms, tests 124 ms)
```

- or failure:

```bash
 ✗ retry.test.ts (1)
  ✗ should run success with retry (6ms) (retry x2)
    expected 1 to be 5 // Object.is equality
    expected 2 to be 5 // Object.is equality
    expected 3 to be 5 // Object.is equality

 ...

 Test Files 1 failed
      Tests 1 failed
   Duration 171 ms (build 23 ms, tests 148 ms)
```