# Sequential Flow Builder?

Last updated: May 14, 2025

If you're a merchant who uses subscriptions to power refills, or who wants to use your subscriptions to create a custom order journey experience, then the Sequential Flow Builder is for you. You can use this tool to swap the product that is delivered to the customer after certain order numbers.

<figure><img src="/files/7QW6Jkkt1zgXGE0BUyav" alt=""><figcaption></figcaption></figure>

## 1. Accessing the Sequential Flow Builder

To access the Sequential Flow Builder, follow these steps:

Log in to your merchant account. Navigate to **Subscription Programs** > **Manage** on the program you wish to add the flow to. Scroll down and Look for the card labeled "Sequential Flow Builder."

<figure><img src="/files/qdnTNMI7IXL7436i69yS" alt=""><figcaption></figcaption></figure>

## 2. Creating a Sequential Flow

Click on the "Add flow" button.&#x20;

Define the starting product by clicking "Browse" next to the text: "**When** the following item(s) are purchased:".

<figure><img src="/files/O175DRtxwbT5dsZxCPCe" alt=""><figcaption></figcaption></figure>

Next, indicate how many orders should eclipse before the swap action happens. By default, this is after order number one.&#x20;

{% hint style="info" %}
**Tip:** Order #1 is considered the initial order the customer places in Shopify. Order #2 is considered the first recurring subscription order. \
\
For example, if you're swapping to a refill product, you would want the swap to happen after order #1.&#x20;
{% endhint %}

Then, select the product variant that should be delivered after the defined order number.&#x20;

{% hint style="info" %}
**Tip:** Want to have more than one swap action? Hover over the indented action steps to reveal icons to quickly **add** or **duplicate** another action step.![](/files/PvPp0GHSIDNhiXFDBymo)
{% endhint %}

Finally, confirm a flow end behavior. By default, this is is **Send last item in perpetuity**—which means that the customer will continue to receive the last item that the subscription swapped to. You can also opt to **End sequence flow**—which will terminate the subscription after all swaps have occurred.

<figure><img src="/files/qGkmBkT8XSmJp5QhLk8h" alt=""><figcaption></figcaption></figure>

Press "Confirm" to save your flow.

## 3. Editing an Existing Sequential Flow

To edit an existing sequential flow, click the "Manage flow" button to reopen the modal:&#x20;

<figure><img src="/files/ZTYi4I2pUbTcaFWx40nv" alt=""><figcaption></figcaption></figure>

## 4. Deleting a Sequential Flow

To delete a sequential flow, press the red "Delete this flow" button. Confirm the deletion when prompted.

<figure><img src="/files/n6j9Hw1WeCCblsivtgvz" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Warning:** Before you can delete flows that already have subscriptions associated with them, you will be prompted to either **Cancel all active subscriptions with this sequence** or **Send the current item in the customers' active subscriptions in perpetuity** before you can continue with flow deletion.
{% endhint %}

## 5. Sequential Best Practices and Tips

1. Did you know you can create multiple flows from within a Subscription Program? To prevent conflicting swaps, each flow is required to have a unique start product.\
   \
   ![](/files/gHRPrm4hqOkyHFwPh7Vg)<br>
2. Don't neglect your flows after creation; reguarly review and update your sequential flows based on changing product offerings or customer feedback.
3. The sequential flow offers 2 actions:&#x20;
   1. Swap item
      1. Changes the product on the 'nth' order.
   2. Add discount
      1. Adds a discount to the 'nth' order. The discount is appended to the subscription's price; meaning that it won't replace the incentive/discount already applied to the subscription.

Congratulations! You are now ready to leverage the Sequential Flow Builder to enhance your subscription management and offer a personalized order journey experience for your customers. If you encounter any issues or have further questions, reach out at <help@smartrr.com>.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.smartrr.com/docs/support/subscription-setup/sequential-flow-builder.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.