Auto-replace the existing subscription on purchase
For one-plan-per-customer stores — when a customer buys a different plan, swap them over automatically instead of blocking the sale.
- Replaces, not blocks
- Plan-switch proration
- Free core
If you enforce one subscription per customer, a blocked checkout can cost a sale. Auto Migrate to New Subscription turns that block into an automatic switch: buying a new plan replaces the existing one using plan-switching proration. It only fires when ArraySubs matches exactly one existing subscription and the new product is a valid switch target. This recipe enables auto-replace.
- A new purchase replaces the existing subscription automatically.
- Pricing uses plan-switch proration, not a double charge.
- No lost sale from a hard block.
- Falls back to ‘switch manually’ if multiple subs match.
The exact configuration
Enter these values and you have the setup live. Every field maps to a real ArraySubs setting.
| Setting | Value |
|---|---|
| One Subscription Per CustomerSettings → General → Multiple Subscriptions | On (required) |
| Auto Migrate to New Subscription Upon CheckoutSettings → General → Multiple Subscriptions | On |
| Pricing on migratePlan Switching | Plan-switch proration (upgrade/downgrade/crossgrade) |
| Fires only whenBehaviour | Exactly one existing sub + new product is an allowed switch target |
When to use this setup
Set it up in 3 steps
A step-by-step guide drawn from the ArraySubs user manual. Open the linked page for the full walkthrough and screenshots.
Enable the one-sub limit
Turn on One Subscription Per Customer — Auto Migrate only appears when this is on.
General SettingsTurn on Auto Migrate
Enable Auto Migrate to New Subscription Upon Checkout so a new purchase replaces the existing plan instead of being blocked.
General SettingsSet up switch targets
Ensure the new product is a valid plan-switch target (Linked Products), since migrate uses the plan-switching proration path.
Plan Switching & Relationships
This recipe is built from these ArraySubs user-manual guides:
Notes & edge cases
Modules behind this recipe
The ArraySubs modules this setup relies on.
Manage Subscriptions
The central admin hub for viewing, creating, editing, exporting, and managing every subscription record.
Subscription Products
Create and manage simple or variable subscription products with trials, signup fees, plan logic, and lifecycle behavior.
Related setups to explore
Other configurations you can build with the same modules.
One subscription per customer
Limit each customer to a single live subscription — block a second purchase while one is active, trial, on-hold, or pending.
Upgrade paths between tiers
Let customers move up to a higher plan with the price difference prorated automatically — Basic → Pro → Enterprise.
Let customers switch in the portal
Turn on self-service plan switching so customers upgrade, downgrade, or crossgrade themselves — no support ticket.
Questions, answered
Unlock the complete Pro stack
Start on the free-forever core today, then choose a paid Pro plan when you need the advanced Pro feature set.
No credit card required · Annual and lifetime options available