# Set up recurring orders

URL: https://docs.sparklayer.io/help/ordering/recurring-orders

Let B2B customers repeat an order weekly, every 2 weeks or monthly: turn on recurring orders, set the review window, choose groups and see what can fail.

> **Quick summary**
>
> - A [recurring order](https://docs.sparklayer.io/help/glossary.md#recurring-order) repeats a customer's order on a schedule: weekly, every 2 weeks or monthly. Customers set one up at checkout, and SparkLayer places each order for them.
> - Turn on **Recurring orders** at **Settings > Configurations > Ordering** in the SparkLayer Dashboard ([open](https://app.sparklayer.io/configuration/general)), or **SparkLayer Wholesale > Settings > Configurations > Ordering** in the Shopify app, and set the **Review window**: how many days customers have to check each order before it's placed.
> - Needs the Growth plan or above. Every customer group can use recurring orders once they're on, unless you turn them off for a group.
> - For how customers create, edit, pause and delete recurring orders, see [Manage recurring orders](https://docs.sparklayer.io/help/ordering/manage-recurring-orders.md).

## How it works

A recurring order and a scheduled order are different things:

| | What it is | Where customers see it |
| --- | --- | --- |
| **Recurring order** | The plan for repeat orders: the products and quantities, how often to order, the shipping and billing addresses and the payment method. It never becomes an order itself. | **My Account > Recurring Orders** |
| **Scheduled order** | One order made from the recurring order ahead of its date, which the customer can check and change before it's placed. | **My Account > Recent Activity**, with the status **Scheduled** |

How a recurring order places orders:

1. **Set up**: The customer turns on Recurring Order at checkout. Their order is placed now, and the recurring order starts from the next order date they pick.
2. **Scheduled**: When the next order date is inside the review window, SparkLayer creates a scheduled order at the customer's current prices and emails them.
3. **Review**: Until its date, the customer can change the scheduled order, or place it early.
4. **Placed**: On its date, SparkLayer places the scheduled order as a normal order in your store.
5. **Repeat**: The next date follows the schedule, and the cycle starts again.

Each scheduled order is independent. Changing one doesn't change the recurring order or any other scheduled order, and changing the recurring order doesn't change a scheduled order that's already been created.

Placed orders reach your store like any other SparkLayer order, with the payment method the customer chose. Pay by Invoice and Pay on Account orders arrive as [Awaiting merchant](https://docs.sparklayer.io/help/glossary.md#awaiting-merchant) until you complete them.

## Turn on recurring orders

Before you start:

- **The Growth plan or above.** On Starter, **Recurring orders** shows "Available on Growth, Pro, and Enterprise" instead of a switch. Change plan at **Account menu > Plan** in the SparkLayer Dashboard ([open](https://app.sparklayer.io/settings/plan)), or **SparkLayer Wholesale > Plan** in the Shopify app.

1. Go to **Settings > Configurations > Ordering** in the SparkLayer Dashboard ([open](https://app.sparklayer.io/configuration/general)), or **SparkLayer Wholesale > Settings > Configurations > Ordering** in the Shopify app.
2. Turn on **Recurring orders** ("Customers can set orders to repeat on a schedule.").
3. Next to **Review window**, click **Edit**.
4. Enter the number of days, between 3 and 7, and click **Update settings**.

Customers now see **Recurring Order** on the last step of the checkout, and a **Recurring Orders** section in [My Account](https://docs.sparklayer.io/help/storefront/interfaces/my-account.md).

## Set the review window

The **Review window** is how many days before an order's date SparkLayer creates the scheduled order. It's between 3 and 7 days, and 3 by default.

A longer window gives customers more time to check each order, but its prices are fixed earlier. A customer who picks a next order date that's already inside the window, such as tomorrow, gets their scheduled order within the hour.

Changing the review window applies to scheduled orders created from then on. Scheduled orders that already exist keep their date.

## Choose which customer groups can use recurring orders

Once recurring orders are on, every customer group can use them: the **Recurring orders** rule shows **Recurring orders are enabled**. To turn them off for a group:

1. [Edit the customer group](https://docs.sparklayer.io/help/customers/customer-groups.md#edit-a-customer-groups-rules), and override **Recurring orders**.
2. Untick **Allow recurring orders to be created**, and click **Save**.

See [Allow recurring orders](https://docs.sparklayer.io/help/customers/customer-groups.md#allow-recurring-orders).

If you turn recurring orders off for a group, or turn off the feature for the whole store, existing recurring orders are [suspended](#suspended-recurring-orders) at their next date. Scheduled orders that already exist are still placed on their date.

## What carries over to each order

| From the recurring order | How it's used |
| --- | --- |
| **Products and quantities** | Each scheduled order is built from them. |
| **Prices** | The customer's prices on the day the scheduled order is created. See [Prices](#prices). |
| **Shipping and billing address** | The addresses saved on the recurring order. If no billing address was saved, the customer's default billing address on that day. |
| **Payment method** | The method saved on the recurring order. |
| **Shipping method** | Not saved. SparkLayer picks the first shipping method available to the customer for each scheduled order. They can change it before it's placed. |

These don't carry over from the checkout where the recurring order was created:

- Custom line items, and products with custom attributes, such as an engraving.
- Free products added by a discount. Only the quantity the customer added is saved.
- Discount codes. 
- Checkout fields, such as a PO number or customer reference, and the requested shipping date. Customers can add them to each scheduled order before it's placed.
- A one-off shipping address entered at checkout. 

### Prices

Prices are fixed when the scheduled order is created, at the start of the review window. If a price list changes during the window, the scheduled order keeps the prices it was created with, and it's placed at those prices.

The next scheduled order uses the customer's prices on the day it's created, so prices can change from one order to the next.

## When an order needs attention

### Scheduled with problems

Some problems don't stop SparkLayer creating the scheduled order. It's created anyway, and the customer is emailed to fix it before its date:

- A product can't be added, for example because its SKU no longer exists.
- Prices or cart rules return errors.
- No shipping method is available to the customer.
- The payment method isn't available to the customer anymore, for example because of a [payment method rule](https://docs.sparklayer.io/help/ordering/payment-method-rules.md).
- The shipping address can't be used, for example because it was deleted.

The recurring order carries on with its schedule either way.

### Not placed

On the scheduled order's date, SparkLayer places it. If it can't, it emails the customer and doesn't try again, so the same order can't be placed twice:

| What happened | What the customer gets |
| --- | --- |
| **The payment method is Pay Online by Card** | A **Complete payment** email with a link to pay. The order isn't placed until they pay. |
| **The order couldn't be placed**, for example because a product is out of stock or the payment method isn't available | A **We couldn't place your recurring order** email. |

The recurring order carries on, and the next scheduled order is created as normal. 

### Suspended recurring orders

A recurring order is **Suspended** when, at its next date, recurring orders are off for the store or for the customer's group. No scheduled orders are created while it's suspended, and the customer isn't emailed. Customers see **Suspended** in **My Account > Recurring Orders**, where they can edit or delete it, but not resume it. 

If a customer's account no longer exists, their recurring orders are deleted.

## Emails customers get

SparkLayer emails the customer the recurring order belongs to. You aren't sent a copy. The emails come from your store's email address, set with **Email domain** at **Settings > Configurations > Store** in the SparkLayer Dashboard ([open](https://app.sparklayer.io/configuration/general)), or **SparkLayer Wholesale > Settings > Configurations > Store** in the Shopify app.

| Email | When it's sent | Button |
| --- | --- | --- |
| **Your next recurring order is coming up** | A scheduled order is created with no problems | **Review order** |
| **Your next recurring order needs attention** | A scheduled order is created [with problems](#scheduled-with-problems) | **Resolve issues** |
| **Your recurring order is ready for payment** | The scheduled order's date has come and the payment method is Pay Online by Card | **Complete payment** |
| **We couldn't place your recurring order** | The scheduled order couldn't be placed on its date | **See what went wrong** |

No email is sent when an order is placed by a recurring order, other than your store's usual order confirmation, or when a recurring order is paused, resumed, deleted or suspended.

To change the design or wording of these emails, see [Templates](https://docs.sparklayer.io/developers/templates.md). Their templates are `recurring-order-scheduled`, `recurring-order-scheduled-with-errors`, `recurring-order-payment-required` and `recurring-order-complete-failed`.

## Company locations

A recurring order is set up for the [company location](https://docs.sparklayer.io/help/customers/company-locations.md) the customer was ordering for at checkout, and each scheduled order uses that location's prices, payment methods and customer group.

If the customer is later removed from that location, or moved to another company, their recurring orders carry on. Scheduled orders then use the customer's own settings instead of the location's: their own customer group, prices and payment methods. This can change prices, or make the payment method unavailable, so the order is [scheduled with problems](#scheduled-with-problems). To stop it, the customer, or a sales rep for them, pauses or deletes the recurring order.

Admins of a company location can see, pause, resume and delete the recurring orders of people at their location, but not edit them.

## Recurring orders and your team

There's no list of recurring orders in the SparkLayer Dashboard, and scheduled orders aren't in **Activity** in the SparkLayer Dashboard ([open](https://app.sparklayer.io/activity)), or **SparkLayer Wholesale > Activity** in the Shopify app until they're placed. To see or change a customer's recurring orders, sign in as them with [Order for a customer](https://docs.sparklayer.io/help/sales-ordering/order-for-a-customer.md).

Sales reps ordering for a customer can create, edit, pause, resume and delete their recurring orders, and edit their scheduled orders, as the customer can.

## Settings

| Setting | Where | What it does | Default |
| --- | --- | --- | --- |
| **Recurring orders** | **Settings > Configurations > Ordering** in the SparkLayer Dashboard ([open](https://app.sparklayer.io/configuration/general)), or **SparkLayer Wholesale > Settings > Configurations > Ordering** in the Shopify app | Lets customers set orders to repeat on a schedule. Needs the Growth plan or above. | Off |
| **Review window** | **Settings > Configurations > Ordering** in the SparkLayer Dashboard ([open](https://app.sparklayer.io/configuration/general)), or **SparkLayer Wholesale > Settings > Configurations > Ordering** in the Shopify app | How many days before its date each scheduled order is created, so customers can review it. 3 to 7 days. | 3 days |
| **Recurring orders** rule | **Companies > Customer groups** in the SparkLayer Dashboard ([open](https://app.sparklayer.io/customers/groups)), or **SparkLayer Wholesale > Companies > Customer groups** in the Shopify app | Whether a customer group can create recurring orders. | Allowed |

## FAQs

**Which frequencies can customers choose?**

**Weekly**, **2 Weeks** or **Monthly**. Weekly orders fall on the same day of the week as the first next order date. Monthly orders fall on the same day of the month, or the last day of a shorter month: a recurring order started on the 31st orders on 28 February and 30 April.

**Is the first order placed straight away?**

Yes. The order the customer checks out with is placed straight away, as normal. The recurring order's first repeat is on the next order date they pick.

**Can customers choose the shipping method for every order?**

No. SparkLayer picks the first shipping method available to the customer for each scheduled order. They can change it on that scheduled order before it's placed.

**Do price changes affect recurring orders?**

Yes, from the next scheduled order. A scheduled order keeps the prices it was created with, and the next one uses the customer's prices on the day it's created.

**Can customers who need their orders approved use recurring orders?**

No. [Limited users](https://docs.sparklayer.io/help/glossary.md#limited-user), whose orders need approving, don't see **Recurring Order** at checkout. A recurring order also can't be set up from a quote, or from a cart loaded from another order.

**What happens to orders already scheduled if I turn recurring orders off?**

They're still placed on their date. Customers can't see or change them while the feature is off. Recurring orders are suspended at their next date, so no new scheduled orders are created.

**Can I see customers' recurring orders in the SparkLayer Dashboard?**

No. Sign in as the customer with [Order for a customer](https://docs.sparklayer.io/help/sales-ordering/order-for-a-customer.md) and open **My Account > Recurring Orders**.
