Shopify App Pricing
About Shopify App Pricing
Shopify App Pricing is Shopify's default pricing option for new public apps submitted for approval. It expands Managed Pricing with support for usage-based charges, an App Events API, and subscription data APIs.
For existing apps, you can switch to Shopify App Pricing if there are no active merchants currently paying for the app.
Pricing setup happens in the Shopify Partner Dashboard. Mantle does not replace Shopify's pricing editor. Instead, Mantle works alongside it by exposing the enhanced customer subscription and usage data through the Mantle App API and dashboard.
What happens in Shopify vs. Mantle
In Shopify
Use Shopify Partner Dashboard to switch pricing models and manage plans.
Switch to Shopify App Pricing
Add and edit Public plans and private plans from Shopify's pricing pages
Configure usage-based charges in your Shopify pricing setup
In Mantle
Use Mantle to read and use billing data after your plans are configured.
Access subscription status and usage data through the Mantle App API to show customers their usage
Enforce feature gates based on subscription status and usage metrics
Browse and export usage events, subscription activity, and more in the Mantle dashboard
View and customize reports based on billing and usage data from the Mantle dashboard
Manage customer access settings, feature overrides, and more
Switch to Shopify App Pricing
To opt in, update the app's pricing settings in Shopify Partner Dashboard.
In your Partner Dashboard, click Apps > All Apps, then click the app you want to update.
Click Distribution. Beside Shopify App Store listing, click Manage listing.
Under Published languages, click Edit for the locale you want to update.
Under Pricing content, click Manage to open the Pricing index page.
Click Settings, select Shopify App Pricing, then in the confirmation dialog click Switch.
You can only switch existing apps that do not have active paying merchants.
Add plans in Shopify
After switching, create your app's plans in Shopify.
In Partner Dashboard, click Apps > All Apps, open your app, then go to Distribution > Manage listing.
Under Published languages, click Edit for the locale you want to update.
Under Pricing content, click Manage to open the Pricing index page.
Under Public plans or Private plans, click Add to open the plan editor.
Usage-based billing and app events
Shopify App Pricing adds usage-based billing support. Mantle complements this by letting you work with usage and event data through the same app API and dashboard.
Sending usage events can be done using the Mantle App API POST /usage_events endpoint. You can then access aggregate metrics about the events for each customer using the GET /customer and GET /usage endpoints on the API.
View the How usage billing works and the Usage events and metrics help pages for details on usage billing in Mantle.
Subscription status and customer data
If you need to check a customer's current billing state, you can use Mantle whether your app is on Shopify App Pricing or Shopify's legacy Billing API. The interface in Mantle is the same.
That means you can use Mantle to access:
Current subscription status
Current plan information
Usage metrics tied to the customer
Usage event history and event names
If you are migrating from Shopify's legacy Billing API, your team can keep using Mantle to read customer billing data without changing where that information is accessed. No code changes required!