Move existing subscriptions using the migration tool in the Partner Dashboard or a new Shopify CLI command. The switch takes effect at the start of the next billing cycle, and merchants don't need to re-approve charges.
The migration tool in the Partner Dashboard, or the Shopify CLI shopify app subscription-migrations command.
Subscriptions move over at the start of the next billing cycle. The switch isn't immediate.
Merchants don't need to re-approve charges, and you don't need to change your app's billing method before migrating.
shopify app subscription-migrations
| Item | Partner Dashboard migration tool | Shopify CLI(subscription-migrations) |
|---|---|---|
| Best for | Simple Plans without usage-based billing, etc. | Complex Usage-based billing, price adjustments, private plans |
| Draft and test plans | Supported Draft from existing manual plans → validate on a development store | Not specified |
| Run migrations | One click to the matching plan | Schedule in bulk |
| Check migration status | Not specified | Supported View status for each store |
| Cancel pending migrations | Not specified | Supported Can also cancel migrations scheduled in the Dashboard |
| Switchover timing | At the start of the next billing cycle · no merchant re-approval (both) | |
Apps that currently bill merchants through the Billing API and plan to move to Shopify App Pricing.
If you use subscription types that the Partner Dashboard tools can't migrate, you need to use Shopify CLI commands.
Apps that already use Shopify App Pricing for subscriptions are not affected.
In the Partner Dashboard, create App Pricing plans that match your existing manual plans and test them on a development store.
Move simple subscriptions that match a plan with the migration tool. They migrate at the start of the next cycle without re-approval.
subscription-migrations to plan and schedule migrations in bulk. Cancel migrations if you need to adjust plans.
Confirm that subscriptions migrated as scheduled and are billed correctly before expanding to more stores.
The migration doesn't take effect the moment you schedule it. If billing cycles start on different dates across stores, plan your verification around migrations completing on different dates for each store.
Merchants aren't asked to re-approve charges, so the migration avoids drop-off from pending approvals.
Usage-based charges, price adjustments, and private plans require the CLI. Your first task is to inventory existing subscriptions by type and decide which tool to use for each.
Pending migrations can be canceled from the CLI, including those scheduled with the Partner Dashboard tool. Keep a CLI environment ready as a safety valve in case you need to revisit your plan design.
The announcement only states that "you don't need to change your billing implementation before migrating"; it doesn't cover how to handle Billing API calls or billing-related logic after the migration.Testing on a development store and reviewing the migration guide (related docs)should be treated as prerequisites.
shopify app subscription-migrations to list migration status per store and schedule migrations in bulk.