> ## Documentation Index
> Fetch the complete documentation index at: https://openemail-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Flows

> Emails that send themselves when a shopper leaves a checkout: build, approve, change and turn off.

A flow sends a series of emails when something happens in your store. Today there's one trigger, **Abandoned checkout**. Your agent builds the flow, and you approve each version before it goes live.

## What starts a run

* **An abandoned checkout:** a shopper gave an email address and placed no order within 10 minutes of their last change. Only checkouts created after install count.
* **Only subscribed contacts:** a run starts if the shopper is subscribed and not on the do-not-email list at that moment. A ticked marketing box at checkout counts as subscribing.
* **One run per contact:** a newer checkout takes the run over without starting the series again, and the next email shows the newer checkout.
* **An order ends it:** any order by the contact ends their run. A message more than 24 hours late is skipped rather than sent.

**1. Build the flow**

* Your agent writes the emails, then saves the flow as a draft: 1 to 5 steps, each an email and the wait before it.
* The first wait is at least 15 minutes after the checkout is abandoned; each later wait is at least 1 hour after the step before. The whole series falls due within 7 days.
* Flow emails can show the checkout: its items, totals and a link back to it. Test each one first, as in [Emails and preview](https://openemail-docs.mintlify.site/use/emails-and-preview.md).

```text Ask your agent wrap theme={"dark"}
Set up abandoned checkout emails: three steps, the first after 1 hour, then 1 day, then 3 days. Send me a test of each email, then ask me to approve the flow.
```

> [!TIP]
>
> **Checkpoint:** the flow shows on **Flows** as **Draft only**.

**2. Turn off the other abandoned checkout emails**

* In the Shopify admin, turn off Shopify's own abandoned checkout email: it's in **Messaging > Automations**, and on older stores also in **Settings > Checkout**.
* Coming from Klaviyo? Set its abandoned checkout flow to draft in Klaviyo. See [Move from Klaviyo](https://openemail-docs.mintlify.site/use/move-from-klaviyo.md).

> [!WARNING]
>
> **Two live flows mean two emails for one checkout.** OpenEmail can't see Shopify's setting, so the approval page reminds you. While Klaviyo is connected, the approval page also names any Klaviyo abandoned checkout flow still live.

> [!TIP]
>
> **Checkpoint:** OpenEmail's flow is the only abandoned checkout email left on.

**3. Approve it**

* Your agent requests approval. That freezes the draft as a flow version, with each step's newest email version, and gives you a link.
* The approval page shows each step's wait and email, the abandoned checkouts of the past 7 days whose contacts are subscribed, and any warnings. **Approve** puts the version live. See [Approvals](https://openemail-docs.mintlify.site/use/approvals.md).

> [!TIP]
>
> **Checkpoint:** **Flows** shows the flow as **Live**, with its live version number.

**4. Watch it**

* Open the flow from **Flows**. **Steps** lists each email in order with its wait in words, its subject and preview text, and its figures: emails handed off, skipped and cancelled, and runs started, not started or ended there, by reason.
* **Summary** shows the trigger, the live version and since when, **Runs going**, and emails handed off in the last 30 days.
* A step marked **Stopped** had its email refused by your sender. It sends nothing while the other steps carry on, and you get an email about it. Ask your agent to fix the email and request approval again; the next approved version resumes the step.

```text Ask your agent wrap theme={"dark"}
How is the abandoned checkout flow doing? Show me each step's figures, and tell me if any step is stopped.
```

> [!TIP]
>
> **Checkpoint:** runs start as checkouts are abandoned, and no step is stopped.

![An abandoned checkout flow with two steps, their waits and email, run counts, and the summary.](https://mintcdn.com/openemail-docs/OnJRIGCNyk9zxe6d/images/use/flow-page.png?fit=max\&auto=format\&n=OnJRIGCNyk9zxe6d\&q=85\&s=f9dd3da6c7b42a9c6083918b6821b426)

**5. Change it**

* Every change goes into a new draft, and the live version keeps running meanwhile. **Waiting for approval** on the flow's page links to the request.
* When the new version goes live, every run going moves to it at its next step, matched by position. Times already set stay; later waits come from the new version. Keep steps in the same order when they should line up.

```text Ask your agent wrap theme={"dark"}
In the abandoned checkout flow, change the second email's subject to "Still thinking it over?" and ask me to approve the new version.
```

> [!TIP]
>
> **Checkpoint:** after you approve, the live version number goes up by one.

**6. Turn it off**

* **Turn off flow** is in the flow page's title bar while it's live. Confirm, and it acts at once, with no approval.
* Every run going ends and its queued emails are cancelled. An email already being handed to your sender may still go out. A request waiting for a new version ends too.
* To turn it back on, ask your agent for a new approval. Runs that ended don't start again; only checkouts abandoned after it's live again start runs.

```text Ask your agent wrap theme={"dark"}
Turn off the abandoned checkout flow.
```

> [!TIP]
>
> **Checkpoint:** **Flows** shows the flow as **Off**, and Activity records who turned it off.

| State | What it means |
| - | - |
| **Live** | A version is approved and running. |
| **Off** | Turned off by a staff member or your agent. Back on needs a new approval. |
| **Draft only** | It has never gone live. |

Next, see everything that keeps sending while you're away: [What runs without you](https://openemail-docs.mintlify.site/run/what-runs-without-you.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.