Managed App Pricing

Managed pricing is the default option when you submit a new public app for approval. You can switch your app to managed pricing by editing your app listing.

Managed pricing is available for free, monthly, and annual recurring plan types.

1. From your Partner Dashboard, click Apps > All Apps and click the name of the app you want to update pricing for.
2. Click Distribution.
3. Beside Shopify App Store listing, click Manage listing.
4. Under Published languages, click Edit for the locale you want to update.
5. Click or scroll down to Pricing details
6. Under Set up plans and pricing, select Managed pricing.
7. In the confirmation dialog, click Switch.

Once you've opted into managed pricing, you can add one or more pricing plans:

1. In the pricing details section of your app listing, click Add.
2. Type a name for your plan.
3. Under Charge type, select whether the plan is a free, monthly, or yearly charge.
4. (Optional) Check This app has a yearly discounted price if it applies.
   1. Under Yearly discounted price, add the corresponding annual price.
5. (Optional) Under A free trial is available, add the number of days your app can be trialed for free.
6. (Optional) Under Plan features, describe what functionality the plan offers.
7. Under Charge approval redirect URL, add a path or URL where the merchant will be redirected after approving the plan charge.
8. Click Save.

Shopify hosts your plan selection page and creates subscriptions for merchants using the prices set in your Shopify App Store listing. Direct your merchants to this page and check their subscription status.

Your app's plan selection page URL follows this pattern:

You can validate that your plan selection page works as expected by following the test charge documentation.

When a merchant approves a subscription, they're redirected to the URL that's specified for that plan. You can configure these URLs on a per-plan basis to customize your app onboarding experience.

We recommend that you query the Billing API for subscription status after approval for charge status changes.

If you've built an embedded app, then you can specify a relative path, such as /welcome. A charge_id URL parameter with a transaction ID is appended to all redirect URLs.

If you have a non-embedded app, or prefer to redirect to an external site, then you can redirect to a valid URL (including the http or https protocol). URL parameters for the charge_id and the merchant shop domain are appended to redirect URLs.

The merchant might choose to back out of selecting a plan by clicking the Cancel button. By default, the cancel action directs the merchant to the app's settings page.

You can optionally redirect to a different URL by passing a goToUrlOnCancel query parameter. Its value can be either a relative path to your embedded app, or a valid absolute URL (including the https or http protocol):

Managed app pricing tracks trial days over a 180-day period to prevent users from repeatedly reinstalling apps to exploit free trial periods. For example, if a merchant uses 12 out of 15 trial days on a Pro Plan, uninstalls, then reinstalls the app 90 days later, they'll still have 3 trial days left for the Pro Plan.

If you update your trial periods, then previously consumed trial days are subtracted from the new totals.

Downgrading from a paid plan to a free plan is deferred, meaning it's effective at the end of the paid plan’s current cycle.

You can issue discounts or extend app trial periods through your Partner Dashboard:

1. From your partner dashboard, search for the name of the merchant you want to offer a discount. Click the merchant name in the Store column of the search results.
2. Beside Discount, click Create.
3. Under App, search for your app by name and select it.
4. Select the type, value, and duration of the discount.
5. Click Create.
6. In the confirmation dialog, click Apply to confirm the discount.

1. From your partner dashboard, search for the name of the merchant whose trial you want to extend. Click the merchant name in the Store column of the search results.
2. Beside Trial extension, click Create.
3. Under App, search for your app by name and select it.
4. Under Extra trial days, enter the number of days to extend the merchant's trial.
5. Click Create.
6. In the confirmation dialog, click Apply to confirm the trial extension.

For both discounts and trial extensions, Shopify sends an email to the merchant on your behalf confirming the discount or trial extension. The merchant doesn't need to re-subscribe to the plan. The discount is applied to their subscription automatically, and starts on the next billing cycle.

To receive a webhook when a subscription is updated, register for the APP_SUBSCRIPTIONS_UPDATE topic. Note that webhooks can take several minutes to deliver. Make sure your app can handle webhook delays and follow Shopify's best practices for webhooks.

• Managed pricing currently supports only fixed, recurring pricing models (for example, $10/month or $100/year).
• Once you opt in, you can’t create new recurring application charges using the Billing API. Charges created before opting into managed pricing continue to process as expected.