--- title: Migrating to Shopify App Pricing description: >- Learn about upcoming migration paths to Shopify App Pricing, including changes for apps already on Managed Pricing (now Shopify App Pricing) and apps on the Billing API. source_url: html: >- https://shopify.dev/docs/apps/launch/billing/shopify-app-pricing/migrating-to-shopify-app-pricing md: >- https://shopify.dev/docs/apps/launch/billing/shopify-app-pricing/migrating-to-shopify-app-pricing.md --- # 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](https://shopify.dev/docs/apps/launch/billing/manual-pricing) with the Billing API, we recommend switching to the new Partner API queries for subscription data — the [Active Subscription API](https://shopify.dev/docs/api/partner/active-subscription) and [Historical Events API](https://shopify.dev/docs/api/partner/historical-events) give you more accurate and persistent subscription and billing data than what's available through the GraphQL Admin API today. **Coming soon:** If your app uses usage-based billing through the Billing API, migration tooling isn't available yet. [See below](#for-apps-on-manual-pricing-billing-api) for details. *** ## New 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](https://shopify.dev/docs/api/partner/active-subscription) | 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](https://shopify.dev/docs/api/partner/historical-events) | 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](https://shopify.dev/docs/api/app-events) | Create usage events for billing meters and custom tracking | Dev Dashboard client credentials (JWT) | `api.shopify.com/app/{version}/events` | *** ## Migration 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. *** ## For 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. ### What'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](https://shopify.dev/docs/apps/launch/billing/shopify-app-pricing#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()` or `currentAppInstallation` queries) 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](https://shopify.dev/docs/apps/launch/billing/shopify-app-pricing#url-redirect-parameters) for the full list of parameters your app should read on redirect. ### What 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](https://shopify.dev/docs/apps/launch/billing/shopify-app-pricing#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. ### What 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](https://shopify.dev/docs/apps/launch/billing/shopify-app-pricing#query-subscription-data). For more detail on the Partner API — including [authentication](https://shopify.dev/docs/api/partner#authentication), [rate limits](https://shopify.dev/docs/api/partner#rate-limits), [error handling](https://shopify.dev/docs/api/partner#error-handling), and the full GraphQL schema reference — see the [Partner API technical reference](https://shopify.dev/docs/api/partner). *** ## 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](https://shopify.dev/docs/api/partner/active-subscription) automatically, giving you more accurate and persistent subscription data. You can also start using the [Historical Events API](https://shopify.dev/docs/api/partner/historical-events) for a full event timeline and the [App Events API](https://shopify.dev/docs/api/app-events) 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. **Coming soon:** 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. ### What 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. ### What you should do now * Familiarize yourself with [Shopify App Pricing](https://shopify.dev/docs/apps/launch/billing/shopify-app-pricing) and how it works. * Review the [Shopify App Pricing limitations](https://shopify.dev/docs/apps/launch/billing/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. *** ## Next steps * Learn more about [Shopify App Pricing features](https://shopify.dev/docs/apps/launch/billing/shopify-app-pricing). * Set up [usage-based pricing](https://shopify.dev/docs/apps/launch/billing/shopify-app-pricing/subscription-billing/setup-usage-charges) with Shopify App Pricing. * Configure [welcome links](https://shopify.dev/docs/apps/launch/billing/shopify-app-pricing#redirection-url) for your plans. ***