Early access
Migrate Paddle Classic subscriptions to Paddle Billing
Map your product catalog and port your subscription data from Paddle Classic to Paddle Billing using the Paddle dashboard.
What's new?
We're releasing a new migration tool that you can use to port your subscription data from Paddle Classic, so that you can take advantage of new features in Paddle Billing. It's coming soon to the Paddle dashboard.
How it works
If you're a longtime Paddle platform user, you might have Paddle Classic. We've released a new version of Paddle called Paddle Billing. It's built on the Paddle platform, but includes an improved developer experience and new features to help you increase your revenue, retain customers, and scale your operations.
Paddle Classic users can activate Paddle Billing at any time by going Paddle > Business Account > Account Settings > Get Paddle Billing.
To avoid disruption to your Paddle Classic integration, Paddle Billing and Paddle Classic have separate sets of data that you can toggle between in the dashboard. However, this meant that there was previously no easy way to port subscriptions from Classic to Billing without contacting our support team.
We're releasing a new migration tool that you can use to migrate active subscriptions from Classic to Billing in the dashboard, choosing how data is mapped between them.
Here's how it works:
Map plans in Classic to products in Billing.
Review prices to be created.
Choose active subscriptions to port from Classic.
You're done! A
subscription.importedwebhook occurs for each imported subscription, so you can update your records.
As Paddle Billing has a totally different architecture, with a new API, SDKs, webhooks, and JavaScript library, you'll need to update your integration to use Paddle Billing before migrating data.
Early access program guidelines
Why are we doing this?
Paddle Billing is a major upgrade over Paddle Classic. It's a complete reimagining of the Paddle platform as a developer-first merchant of record, with features like multi-product subscriptions, unified product catalog, customer portal, and one-page checkout to help you take your billing operations to the next level.
We first launched migrations from Paddle Classic to Paddle Billing last year, asking users to contact us if they were interested in migrating. The demand was massive, and we've migrated hundreds of users to date.
To make it easy for everyone to take advantage of the power of Billing, we're introducing screens in the dashboard you can use to migrate active subscriptions from Classic yourself.
Behind the scenes, it's backed by the same robust tooling that we've used to port over one million subscriptions to Paddle Billing to date. Our engineering team oversees migrations, and they're on hand to help where there's a problem.
What's included?
You can use the migration tool to:
- Map plans in Paddle Classic to products in Paddle Billing.
- Create prices for mapped products in Paddle Billing, including prices for currency overrides in Classic.
- Choose which active subscriptions you'd like to port from Paddle Classic.
Before you start, we'll check that you're ready to move to Paddle Billing. You'll need to update your integration to work with Paddle Billing and have completed a checkout at least once.
Ahead of general release, we've updated our migrations docs so that they're more comprehensive. They walk through key features in Paddle Billing, how workflows in Paddle Classic map to those in Paddle Billing, how the new dashboard screens work, and recommendations for migration based on your revenue stream.
Are there any limitations?
The migration tool is full-featured and ready to rely on. We're launching an early access program to help us gather interest and monitor performance, before rolling it out generally to all users.
You don't need to migrate subscriptions all in one go — you can choose which subscriptions you migrate as part of the process, and migrate subscriptions in batches.
For the initial stage of release, exporting a list of migrated subscriptions from the dashboard may not be available. This is scheduled to land before general release.
What do we need from you?
While in early access, we're keen to hear about how you feel the experience works. To send us feedback, use the feedback button at the top-right of any page in the docs. We may contact you during the early access program to get your thoughts.
What's the timeline for release?
We're planning to release migrations in the dashboard in multiple stages:
| Stage 1 | Completed | Support-assisted migrations available. |
| Stage 2 | Q2 2025 | Tool to migrate subscriptions in the dashboard available in early access. |
| Stage 3 | H2 2025 | Full release of our migration tool in the dashboard, including the option to export a list of imported subscriptions. |
Next steps
Access to migrations in the dashboard is limited to users who are part of our early access program. If you're interested in being part of the program, fill out the form to join the waitlist. We'll reach out when space is available if you meet the program requirements.
As part of your migration, you'll need to build an integration with Paddle Billing, then run it alongside your integration with Paddle Classic while you port subscription data over from Classic to Billing. You should be prepared to run two integrations for a little while.
After you've got access to the migration tooling and ported subscription data from Classic to Billing, you can safely turn off your Paddle Classic integration. You'll still have access to Paddle Classic for historical data reporting and to take actions like issue refunds or download receipts.
Review our migration docs to learn how data in Paddle Classic maps to data in Paddle Billing, and how to plan for your migration.