Pricing plans for GitHub Marketplace apps

Pricing plans allow you to provide your app with different levels of service or resources. You can offer up to 10 pricing plans in your GitHub Marketplace listing.

In this article

GitHub Marketplace pricing plans can be free, flat rate, or per-unit, and GitHub lists the price in US dollars. Customers purchase your app using a payment method attached to their GitHub account, without having to leave You don't have to write code to perform billing transactions, but you will have to handle billing flows for purchase events.

If the app you're listing on GitHub Marketplace has multiple plan options, you can set up corresponding pricing plans. For example, if your app has two plan options, an open source plan and a pro plan, you can set up a free pricing plan for your open source plan and a flat pricing plan for your pro plan. Each GitHub Marketplace listing must have an annual and a monthly price for every plan that's listed.

For more information on how to create a pricing plan, see "Setting a GitHub Marketplace listing's pricing plan."

Note: If you're listing an app on GitHub Marketplace, you can't list your app with a free pricing plan if you offer a paid service outside of GitHub Marketplace.

Types of pricing plans

Free pricing plans are completely free for users. If you set up a free pricing plan, you cannot charge users that choose the free pricing plan for the use of your app. You can create both free and paid plans for your listing. Unverified free apps do not need to implement any billing flows. Free apps that are verified by Github need to implement billing flows for new purchases and cancellations, but do not need to implement billing flows for free trials, upgrades, and downgrades. If you add a paid plan to an app that you've already listed in GitHub Marketplace as a free service, you'll need to resubmit the app for review.

Flat rate pricing plans charge a set fee on a monthly and yearly basis.

Per-unit pricing plans charge a set fee on either a monthly or yearly basis for a unit that you specify. A "unit" can be anything you'd like (for example, a user, seat, or person).

Marketplace free trials provide 14-day free trials of OAuth or GitHub Apps to customers. When you set up a Marketplace pricing plan, you can select the option to provide a free trial for flat-rate or per-unit pricing plans.

Free trials

Customers can start a free trial for any available paid plan on a Marketplace listing, but will not be able to create more than one free trial for a Marketplace product.

Free trials have a fixed length of 14 days. Customers are notified 4 days before the end of their trial period (on day 11 of the free trial) that their plan will be upgraded. At the end of a free trial, customers will be auto-enrolled into the plan they are trialing if they do not cancel.

See "New purchases and free trials" for details on how to handle free trials in your app.

Note: GitHub expects you to delete any private customer data within 30 days of a cancelled trial, beginning at the receipt of the cancellation event.

Did this doc help you?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.