Migrating to Shopify App Pricing
Managed Pricing has been renamed to Shopify App Pricing. If your app was using Managed Pricing, it is now part of Shopify App Pricing — billing continues without interruption, but there are API changes you'll need to make.
Whether you're already on Shopify App Pricing or currently on manual pricing with the Billing API, we recommend switching to the new Partner API queries for subscription data — the Active Subscription API and Historical Events API give you more accurate and persistent subscription and billing data than what's available through the GraphQL Admin API today.
If your app uses usage-based billing through the Billing API, migration tooling isn't available yet. See below for details.
If your app uses usage-based billing through the Billing API, migration tooling isn't available yet. See below for details.
Anchor to New API overviewNew API overview
Shopify App Pricing is backed by three APIs. The Active Subscription and Historical Events APIs are accessed through the Partner API using Partner API credentials. The App Events API uses separate credentials from the Dev Dashboard.
| API | Purpose | Auth | URL |
|---|---|---|---|
| Active Subscription API | Query a merchant's current plan, billing cycle, and subscription items | Partner API client credentials | partners.shopify.com/{org_id}/api/{version}/graphql.json |
| Historical Events API | Query a full timeline of installs, charges, earnings, and subscription changes | Partner API client credentials | partners.shopify.com/{org_id}/api/{version}/graphql.json |
| App Events API | Create usage events for billing meters and custom tracking | Dev Dashboard client credentials (JWT) | api.shopify.com/app/{version}/events |
Anchor to Migration at a glanceMigration at a glance
If your app used any of Shopify's billing APIs before May 2026, this migration applies to you.
Your migration path depends on which billing API you use today and what you bill for. Find your row below, then follow the matching section for full instructions.
| Today you're using… | Code changes | Plan & pricing changes | Data migration & tool |
|---|---|---|---|
| Managed Pricing | Switch to new APIs | None | None — no tool required |
| Shopify App Pricing | Ensure you're on the new APIs / Switch to the new APIs | None | None — no tool required |
| Billing API — one-time charges only | Switch to new APIs | Create a usage-only subscription with usage items; next purchase flows through it | No data migration needed; old charges surface via the Historical Events API. Migration tool is optional (plan handles only) |
| Billing API — one-time + monthly | Switch to new APIs | Same as above for the one-time portion | No data migration needed. Migration tool is optional (plan handles only) |
| Billing API — simple monthly/yearly (no usage) | Switch to new APIs | Confirm plans in App Store, assign plan handles | No data migration needed. Migration tool is optional (plan handles only) |
| Billing API — usage-based | Switch to new APIs; bounce between the old and new usage APIs during transition | Define meters/events; set per-plan usage prices | Required — remap active subscriptions to plans with meters and rates using the Shopify-provided migration tool |
For every path except Billing API usage-based apps, the migration tool is a convenience for tidying up plan handles across existing subscriptions — not a gate. Billing API usage-based apps are the only cohort that can't onboard without it, because the new usage API only operates on subscriptions that have meters and rates attached.
Anchor to For apps already on Shopify App PricingFor apps already on Shopify App Pricing
If you're already using Shopify App Pricing (formerly known as Managed Pricing), you'll need to update how your app retrieves subscription data. Subscription data is moving from the GraphQL Admin API to the Partner API.
Anchor to What's changingWhat's changing
- Subscription queries: Your app will need to query the Partner API instead of the GraphQL Admin API to retrieve subscription status, plan details, and billing information. See query subscription data for the Partner API queries.
- Billing checks: Code that uses the GraphQL Admin API to check subscription status (such as
billing.check()orcurrentAppInstallationqueries) will need to be updated to use the Partner API equivalents. - Return URL parameters: The return URL after a merchant approves a charge now includes additional URL parameters. See URL redirect parameters for the full list of parameters your app should read on redirect.
Anchor to What isn't changingWhat isn't changing
- How you integrate with the plan selection page: The URL and redirect flow to Shopify's hosted plan selection page works the same way. Your redirection URL configuration, how you send merchants to plan selection, and how Shopify redirects them back to your app are unchanged.
- Your plans and pricing configuration: Plans you've already configured in the Partner Dashboard don't need to change.
- Merchant experience: Merchants see no interruption. There's nothing they need to do.
Anchor to What you should do nowWhat you should do now
- Review where your app queries the GraphQL Admin API for subscription or billing data.
- Identify all code paths that depend on subscription status checks.
- Update your subscription status and history queries to use the Partner API.
For more detail on the Partner API — including authentication, rate limits, error handling, and the full GraphQL schema reference — see the Partner API technical reference.
Anchor to For apps on manual pricing (Billing API)For apps on manual pricing (Billing API)
If your app uses flat-rate recurring charges (monthly or yearly) or one-time charges, you can start taking advantage of Shopify App Pricing features today — without waiting for migration tooling. Your existing subscriptions will surface in the Active Subscription API automatically, giving you more accurate and persistent subscription data. You can also start using the Historical Events API for a full event timeline and the App Events API for usage tracking and analytics.
If your app uses usage-based billing through the Billing API, full migration requires the Shopify-provided migration tool to remap your active subscriptions to plans with meters and rates. That tooling is in development.
Migration tooling for apps with active Billing API usage-based charges isn't available yet. We're building tools to help you transition your existing subscriptions to Shopify App Pricing without disrupting your merchants.
Migration tooling for apps with active Billing API usage-based charges isn't available yet. We're building tools to help you transition your existing subscriptions to Shopify App Pricing without disrupting your merchants.
Anchor to What to expectWhat to expect
- Automated migration tooling: Tools to help you move existing merchant subscriptions from the Billing API to Shopify App Pricing plans.
- No merchant disruption: The migration path is being designed so that existing merchants won't need to resubscribe or take any action.
- Gradual rollout: You'll be able to migrate at your own pace once the tooling is available.
Anchor to What you should do nowWhat you should do now
- Familiarize yourself with Shopify App Pricing and how it works.
- Review the Shopify App Pricing limitations to ensure your pricing needs are covered.
- Document your current billing configuration, including plan details, pricing tiers, and any usage-based charges.
Anchor to Next stepsNext steps
- Learn more about Shopify App Pricing features.
- Set up usage-based pricing with Shopify App Pricing.
- Configure welcome links for your plans.