> For the complete documentation index, see [llms.txt](https://help.smartrr.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smartrr.com/docs/support/subscription-setup/maximum-minimum-finite-subscription-plans.md).

# Maximum/minimum (finite) subscription plans

This optional subscription plan setting allows brands to define a required maximum or minimum number of billing cycles for any subscription plan.

The maximum billing cycle makes it possible to automatically expire a subscription once it hits the defined billing cycles. Whereas the minimum billing cycle setting doesn't allow the customer to cancel their subscription until the minimum billing cycle is met.

> Can customers cancel before the minimum is met? cycles is reached.

No — the Cancel action is hidden in the account portal until the minimum number of billing. These subscriptions can be canceled in the Smartrr admin portal/app.

{% hint style="info" %}
The two most common use cases for this setting include 1) finite gifted subscriptions or 2) minimum orders required at initial purchase.

**1) Finite use case example:** Customer purchases a monthly gift subscription for a 6 month term. Subscription automatically ends after 6 months.

**2) Minimum orders required example:** Customers are required to sign up for a minimum of 3 cycles (orders) with a new subscription. Only after this 3rd consecutive order will the customer be presented with the option to cancel their entire subscription in the [<mark style="color:blue;">customer account portal</mark>](/docs/support/customer-account-portal/accessing-the-customer-account-portal.md#what-the-smartrr-customer-portal-looks-like).
{% endhint %}

{% hint style="warning" %}
As of July 1, 2022, merchants selling to customers in **California, United States** may not be able to offer minimum required billing cycles. In states such as California, customers should be able to cancel their subscriptions at any point in time. The minimum billing cycle takes this ability away from the customer while they haven't satisfied the minimum billing cycle set in place for the subscription. So, it's best recommended that brands in California refrain from using the minimum billing cycle setting. Please [<mark style="color:blue;">read here</mark>](https://www.jdsupra.com/legalnews/amendments-to-california-s-automatic-4857722/) for more information.
{% endhint %}

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2Fa6h0mO8gpW1q53zzHdgO%2Fmin-max.gif?alt=media&amp;token=a0daf9b3-0086-4d11-a8b8-96c6c9ce2c6b" alt="Each selling plan has a &#x22;Max/Min&#x22; setting. Navigate to this section on any selling plan to set a minimum billing cycle or maximum billing cycle."><figcaption></figcaption></figure>

### Setting up a maximum/minimum billing cycle

To define a maximum or minimum number of billing cycles for a selling plan go to **Subscription Programs** in the left hand navigation.&#x20;

In the relevant subscription program, click on the tab Max/Min tab for the specific subscription plan you want:

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FQaa6elTmIIFj9JjCA2c7%2FScreenshot%202024-03-26%20at%2009.08.26.png?alt=media&amp;token=1fc52c79-d0a1-426a-8c92-abafab1262a0" alt="Minimum billing cycle controls the display of the cancel action in the subscription portal. The maximum billing cycle is used to auto-expire subscriptions when they meet the criteria (if this is set to 4, then a monthly subscription will expire when it creates its 4th order)."><figcaption></figcaption></figure>

Define minimum and/or maximum number of billing cycles using the input fields.&#x20;

### How they work?

<table><thead><tr><th width="203.5614013671875">Finite Billing Cycles</th><th width="246.9825439453125">Function</th><th width="299.5982666015625">Example</th></tr></thead><tbody><tr><td>Minimum billing cycles</td><td>Controls the display of the subscription's cancel action to customers in the customer portal.</td><td><p><strong>Example:</strong> On a selling plan with a 30% discount, set a minimum of 3 billing cycles. The first order at checkout counts as the first cycle, so the customer will receive 2 recurring renewals before they can cancel (the cancel action remains hidden in the customer portal until the minimum billing cycle is met).<br></p><p>This helps make sure your highest discounts go to customers who stay subscribed, rather than to one-time orders placed only to get the checkout discount.</p></td></tr><tr><td>Maximum billing cycles</td><td>Used to auto-expire a subscription.</td><td>You may decide to run a 6-month promotional subscription on a variety pack SKU, delivered monthly. Setting a 6 cycle maximum billing cycle on a monthly selling plan, will ensure that the subscription ends after its 6th order (including the initial order at checkout) is created.<br><br>Once expired, the subscription is unable to be reactivated. Making this setting great for promotions or a limited membership.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.smartrr.com/docs/support/subscription-setup/maximum-minimum-finite-subscription-plans.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
