# Flow runs

> Test a flow, run past orders through it, and follow each run step by step to see what it sent and why it stopped.

Breadcrumb: Flows › Flow runs · Updated: 2026-10-17
Docs index: https://docs.cevoid.com/llms.txt

A run is one pass through a flow, started by one trigger event, such as one delivered order. Each flow's page lists its runs, and each run shows the path it took through the flow, step by step. Test runs and past orders you enroll are runs too.

Navigate to [Settings → Flows](https://app.cevoid.com/settings/flows) and open a flow to see its runs.

## How runs work

- Each trigger event starts a run in every live flow on that trigger, even when a _Filter_ ends the run at once. See [Flows](https://docs.cevoid.com/flows.md).
- A run follows the version of the flow that was live when it started, even after you publish changes
- Every email and event a run sends, test sends included, is listed in [Outbox](https://docs.cevoid.com/flows/outbox.md). Review requests also show in [Request tracking](https://docs.cevoid.com/reviews/collect/request-tracking.md), except those sent to a webhook.

| Status | What it means |
| --- | --- |
| _Queued_ | The run is about to start |
| _Running_ | Cevoid is working through the run's steps |
| _Waiting_ | The run is held at a _Wait_, or its action is scheduled to send later |
| _Completed_ | The run reached its end. A run stopped by a _Filter_ or a review gate is _Completed_ too |
| _Failed_ | A step failed. See [Retry a run](https://docs.cevoid.com/flows/flow-runs#retry-a-run) |
| _Cancelled_ | The run was canceled. See [Cancel a run](https://docs.cevoid.com/flows/flow-runs#cancel-a-run) |

## Test a flow

A test run runs a flow once, on a real order, review, or member, or on sample data. Its sends are real, but they go to test destinations: emails go to your own address instead of the customer's.

1. Navigate to [Settings → Flows](https://app.cevoid.com/settings/flows)
2. Click **...** in the flow's row
3. Select **Trigger test run**
4. Select what to run the test on, such as an order in _Order_
5. Optional: Select **Current draft** or **Live version** in _Version_
6. Click **Start test run**. The test run opens.

What you can run a test on depends on the trigger:

- **Order triggers:** An order from your store. When your workspace has no orders yet, **Mock order** uses sample data.
- **Review triggers:** A product review or a company review from your workspace
- **Upload and loyalty triggers:** A member in _Member_, with the event's details, such as the tier or the expiry date. Cevoid simulates the event and doesn't change any points, tiers, or rewards. Dates must be in the future.

_Current draft_ runs the last saved draft, so save your changes first. It's offered while the draft differs from the live version.

| Target | In a test run |
| --- | --- |
| Email | Goes to the team member who started the test |
| Klaviyo | Sent as an event for the Cevoid test user, `test@cevoid.com`. Your Klaviyo flows may react to it |
| Voyado | Sent as an interaction for the Cevoid test user. Your Voyado automations may react to it |
| Webhook | With _Current draft_, the request is checked but not sent. With _Live version_, it posts to your real endpoint |

Test runs show in _Runs_ with a _Test_ badge. Your workspace can start 20 test runs an hour.

### Skip a wait in a test run

A test run keeps the flow's timing, so an action after a _Wait_ is scheduled for when the wait ends. In a test run, you can send it now.

1. Navigate to [Settings → Flows](https://app.cevoid.com/settings/flows) and open the flow
2. Click the test run under _Runs_
3. Click the _Wait_ step that's waiting
4. Click **Skip wait**. The next step sends now instead of at its scheduled time.

A scheduled action in a test run shows **Continue now** instead, which sends it right away. Live runs always keep the flow's timing.

## Enroll past orders

Enrolling past orders runs a live flow once over orders from a date you choose, as if each order were fulfilled or delivered now. It's for live flows on _Order fulfilled_ or _Order delivered_.

1. Navigate to [Settings → Flows](https://app.cevoid.com/settings/flows)
2. Click **...** in the flow's row
3. Select **Enroll historical orders**
4. Set _Enroll orders since_ to the earliest order date to include. Orders from that date through today are included.
5. Optional: Select a market in _Market_. The default is **All markets**.
6. Click **Start enrollment**

- **What's included:** Orders placed in that period that are fulfilled, or delivered for an _Order delivered_ flow. The dialog shows how many match before you start.
- **Timing:** Each order runs through the whole flow, waits and filters included, counted from when you start the enrollment
- **Progress:** _Historical runs_, below your flows on [Settings → Flows](https://app.cevoid.com/settings/flows), shows each enrollment with its market, status, and results. To stop one, click **Cancel** there, or select **Cancel bulk enrollment** in the flow's row menu.
- **Review requests:** Customers who have already reviewed are skipped, so import your existing reviews first. See [Send requests to past orders](https://docs.cevoid.com/reviews/collect/review-requests.md#send-requests-to-past-orders).

## Runs on a flow's page

_Runs_, on a flow's page, lists the flow's runs, newest first. Click a row to open the run.

| Column | What it shows |
| --- | --- |
| _Run_ | The run's number, with _Test_ for a test run |
| _Subject_ | The order or review that started the run |
| _Version_ | The flow version the run follows, or _Draft_ for a test run of the draft |
| _Status_ | Where the run stands. See [How runs work](https://docs.cevoid.com/flows/flow-runs#how-runs-work) |
| _Started_ | When the run started. Hover over it for the exact time |

## Open a run

A run's page shows the flow as the run follows it. The path the run took is highlighted, and each card shows its step's state, such as _Completed_, _Waiting_, _Scheduled_, or _Skipped_.

1. Navigate to [Settings → Flows](https://app.cevoid.com/settings/flows) and open the flow
2. Click the run under _Runs_. _Run details_ opens next to the canvas.

| Row | What it shows |
| --- | --- |
| _Status_ | The status of the attempt you're looking at |
| _Attempt_ | The attempt's number. Each retry is a new attempt |
| _Version_ | The flow version the attempt follows |
| _Mode_ | _Live_ or _Test_ |
| _Subject_ | The order or review. Click it to open it |
| _Next wake_ | When a waiting run continues |

When a step stopped the run, a notice says which step and why, such as _Stopped by Filter_ with the condition that didn't match, or that an action wasn't sent, with the reason. _Timeline_ lists each step on the run's path with its time, starting at _Event received_. A waiting step counts down to when it continues. To look at another run or attempt, select it in the menus above the canvas.

## See why a step didn't run

Each step in an open run has its own details: click its card to see its status, when it started and finished, and for an action, its delivery status.

- **A skipped step:** _Why this step was skipped_ or _Why this step did not run_ explains it, such as _The run took the other path_ after an _If / else_, with the condition that decided it
- **A review gate:** _Gate decision_ shows _Passed_, _Passed with exclusions_, or _Blocked_, with each check and the products the gate left out. See [Who gets a review request](https://docs.cevoid.com/reviews/collect/review-requests.md#who-gets-a-review-request).
- **A failed step:** The error shows in the step's details

## Retry a run

When a step fails, **Retry** above the run's canvas runs the flow again as a new attempt.

1. Navigate to [Settings → Flows](https://app.cevoid.com/settings/flows) and open the flow
2. Click the run under _Runs_
3. Click **Retry**
4. Select how to retry. The new attempt opens.

| Option | What it does |
| --- | --- |
| **Retry from start** | Runs the attempt again from the first step |
| **Retry from failed** | Continues from the step that failed |
| **Retry with live flow** | Runs the flow's current live version |

## Cancel a run

Canceling a run stops it, and its scheduled emails and events aren't sent. **Cancel run** shows above the canvas while the run is still going.

1. Navigate to [Settings → Flows](https://app.cevoid.com/settings/flows) and open the flow
2. Click the run under _Runs_
3. Click **Cancel run**. The status changes to _Cancelled_.

## Related articles

- [Flows](https://docs.cevoid.com/flows.md)
- [Outbox](https://docs.cevoid.com/flows/outbox.md)
- [Request tracking](https://docs.cevoid.com/reviews/collect/request-tracking.md)
- [Review requests](https://docs.cevoid.com/reviews/collect/review-requests.md)

---

Canonical: https://docs.cevoid.com/flows/flow-runs