# Min/Max Order Requirements

### Introduction

Min/Max Order Requirements give you full control over the duration of your subscription plans. By setting a minimum number of orders, you ensure customers commit to a certain number of deliveries before they can cancel. By setting a maximum number of orders, you can automatically expire subscriptions after a specific number of deliveries — perfect for seasonal plans, limited product runs, or trial offers.

This feature helps you protect your revenue by preventing early cancellations, while also giving customers clear expectations about how their subscription works.

***

### Understanding the requirements

Joy Subscriptions lets you define two types of order requirements for each frequency option within a subscription plan:

* **Minimum required number of orders** — The smallest number of orders a customer must complete before the subscription can be canceled. For example, setting a minimum of 3 means the customer is committed to at least 3 deliveries.
* **Maximum allowed number of orders** — The largest number of orders a subscription will process. Once the maximum is reached, the subscription automatically expires. For example, setting a maximum of 12 means the subscription ends after 12 deliveries.

Both settings are optional. You can use them individually or together:

| Configuration            | Behavior                                                                                             |
| ------------------------ | ---------------------------------------------------------------------------------------------------- |
| No minimum, no maximum   | Subscription runs indefinitely until the customer cancels                                            |
| Minimum only             | Customer must complete the minimum orders before canceling, then subscription continues indefinitely |
| Maximum only             | Subscription automatically expires after the set number of orders                                    |
| Both minimum and maximum | Customer must complete the minimum, and the subscription expires after the maximum                   |

When a subscription reaches the maximum number of orders, its status changes to **Expired**. You can reactivate it by increasing the maximum order limit from the subscription detail page.

***

### How to set min/max requirements when creating a plan

**Step 1:** Navigate to **Joy Subscriptions → Plans** and click **+ Create plan**.

**Step 2:** Add your products and configure the frequency option. Click **Edit** on the frequency card to open the plan editor.

**Step 3:** Scroll down to the **Requirements** section. Check the **Minimum required number of orders** checkbox to enable the minimum order requirement.

**Step 4:** Enter the minimum number of orders. For example, enter **3** to require customers to complete at least 3 orders.

**Step 5:** Check the **Maximum allowed number of orders** checkbox to enable the maximum order requirement.

**Step 6:** Enter the maximum number of orders. For example, enter **12** to automatically end the subscription after 12 orders.

**Step 7:** Click the back arrow to return to the plan creation page, then click **Save** to apply your settings.

***

### Tips & best practices

* **Use minimum orders to reduce early churn.** If you offer a discount on subscriptions, set a minimum to ensure customers stay long enough for the discount to pay off. For example, if you give 15% off, set a minimum of 3 orders.
* **Use maximum orders for seasonal or limited plans.** If you sell a 6-month seasonal coffee subscription, set the maximum to 6 so it ends automatically.
* **Expired subscriptions can be reactivated.** When a subscription reaches its maximum, it becomes **Expired**. You can increase the maximum number from the subscription detail page to reactivate it — the status will change back to **Active**.
* **Customers see clear expectations.** When requirements are set, the subscription plan summary shows the duration (e.g., "Min 2 orders, Max 10 orders"), so customers know what to expect before subscribing.
* **No requirements means unlimited.** If you leave both checkboxes unchecked, the subscription runs indefinitely with no duration limit.

***

### Overall

Min/Max Order Requirements help you design subscription plans that match your business strategy. Set a minimum to protect your revenue and reduce churn, or set a maximum to create time-limited subscription offers. Together, they give you precise control over subscription duration while keeping the experience transparent for your customers.

***


---

# 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://docs.avada.io/joy-subscriptions/features/subscription-plan/min-max-order-requirements.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.
