# Limit customers to one subscription

Direct customers to manage their subscription when they already have one.

# Stripe-hosted page

> This is a Stripe-hosted page for when payment-ui is stripe-hosted. View the original doc at https://docs.stripe.com/payments/checkout/limit-subscriptions?payment-ui=stripe-hosted.

You can redirect customers that already have an active subscription to the *customer portal* or your website to manage their subscription. This redirection works with *Checkout* (including the [pricing table](https://docs.stripe.com/payments/checkout/pricing-table.md)) and Payment Links.

Stripe uses either the [Customer object](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer) (if you provide it in the Checkout Session) or the email address to detect if a customer already has an active subscription.

![Manage subscription](images/checkout/manage-subscription.png)

## Direct your customers to the customer portal or your website

1. [Activate the no-code customer portal](https://docs.stripe.com/customer-management/activate-no-code-customer-portal.md) to allow your customers to log in and manage their subscriptions. You need to keep the login link for the customer portal enabled to keep this feature enabled. Disabling the login link disables this feature, which means that customers can create multiple subscriptions.
1. Enable redirecting your customers to the customer portal in your [Checkout and Payment Links settings](https://dashboard.stripe.com/settings/checkout#subscriptions).

![Subscription settings](images/checkout/subscription-settings.png)

You can redirect customers with active subscriptions to your website. To do this, go to the [Checkout and Payment Links settings](https://dashboard.stripe.com/settings/checkout#subscriptions) page.
Optionally, provide `{CHECKOUT_SESSION_ID}` and `{CUSTOMER_EMAIL}` in the URL to populate them when customers redirect to your website.

Example website: `https://togethere.pro/login?session_id={CHECKOUT_SESSION_ID}&customer_email={CUSTOMER_EMAIL}`

![Subscription settings](images/checkout/subscription-settings-website.png)

## Active subscription statuses

Active subscriptions have the following [four statuses](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-status):

* `Active`
* `PastDue`
* `Unpaid`
* `Paused`

# Embedded form

> This is a Embedded form for when payment-ui is embedded-form. View the original doc at https://docs.stripe.com/payments/checkout/limit-subscriptions?payment-ui=embedded-form.

You can redirect customers that already have an active subscription to the *customer portal* or your website to manage their subscription. This redirection works with *Checkout* (including the [pricing table](https://docs.stripe.com/payments/checkout/pricing-table.md)) and Payment Links.

Stripe uses either the [Customer object](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer) (if you provide it in the Checkout Session) or the email address to detect if a customer already has an active subscription.

![Manage subscription](images/checkout/manage-subscription.png)

## Direct your customers to the customer portal or your website

1. [Activate the no-code customer portal](https://docs.stripe.com/customer-management/activate-no-code-customer-portal.md) to allow your customers to log in and manage their subscriptions. You need to keep the login link for the customer portal enabled to keep this feature enabled. Disabling the login link disables this feature, which means that customers can create multiple subscriptions.
1. Enable redirecting your customers to the customer portal in your [Checkout and Payment Links settings](https://dashboard.stripe.com/settings/checkout#subscriptions).

![Subscription settings](images/checkout/subscription-settings.png)

You can redirect customers with active subscriptions to your website. To do this, go to the [Checkout and Payment Links settings](https://dashboard.stripe.com/settings/checkout#subscriptions) page.
Optionally, provide `{CHECKOUT_SESSION_ID}` and `{CUSTOMER_EMAIL}` in the URL to populate them when customers redirect to your website.

Example website: `https://togethere.pro/login?session_id={CHECKOUT_SESSION_ID}&customer_email={CUSTOMER_EMAIL}`

![Subscription settings](images/checkout/subscription-settings-website.png)

## Active subscription statuses

Active subscriptions have the following [four statuses](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-status):

* `Active`
* `PastDue`
* `Unpaid`
* `Paused`

# Embedded components

> This is a Embedded components for when payment-ui is embedded-components. View the original doc at https://docs.stripe.com/payments/checkout/limit-subscriptions?payment-ui=embedded-components.

Elements with Checkout Sessions API doesn’t support limiting customers to one subscription.