> Meticulous records real user sessions from a web app and replays them against each commit to catch visual regressions.
>
> Full AI-readable docs index (complete project setup journey + every page as markdown): https://app.meticulous.ai/llms.txt

# Retry a test run

In this guide, we'll show you how to retry a Meticulous test run if there are failures. It should hopefully be very rare that you need to do this.
The Meticulous team will have already been alerted and be investigating the root cause.

To re-run the workflow, you can always push up another commit:

```bash
git commit --allow-empty -m "Retry Meticulous" && git push
```

However sometimes it's faster to just re-run the workflow directly in your CI system. Those instructions depend on your CI provider:

### GitHub Actions

Meticulous will show as two checks. The first shows the Meticulous results, and has the Meticulous logo next to it:

![The Meticulous check](https://assets.meticulous.ai/docs/retry-test-run/1-meticulous-check.png)

The second is your GitHub Actions workflow that triggers Meticulous:

![Workflow to retrigger](https://assets.meticulous.ai/docs/retry-test-run/2-workflow-to-retrigger.png)

It's this second workflow that you need to re-trigger. To do so click 'View Details'. It will show the workflow steps, where
one of those workflow steps is the step that triggers Meticulous:

![Checking correct workflow](https://assets.meticulous.ai/docs/retry-test-run/3-checking-correct-workflow.png)

Click the 'Re-run this job' button in the top right:

![Re-run](https://assets.meticulous.ai/docs/retry-test-run/4-re-run.png)

This will open a modal where you can re-run the workflow:

![Re-run modal](https://assets.meticulous.ai/docs/retry-test-run/5-re-run-modal.png)

### Other CI Runners

Use the native retry functionality in your CI provider to re-run the workflow that runs the Meticulous tests, or run:

```bash
git commit --allow-empty -m "Retry Meticulous" && git push
```

This will push up a new commit and trigger a new workflow run.