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. Prices are set, displayed, and processed in US dollars. Paid plans are restricted to apps published by verified publishers. For more information about becoming a verified publisher, see "Applying for publisher verification for your organization."

Customers purchase your app using a payment method attached to their GitHub account, without having to leave GitHub.com. You don't have to write code to perform billing transactions, but you will have to handle events from the GitHub Marketplace API. For more information, see "Using the GitHub Marketplace API in your app."

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

Free apps are encouraged in GitHub Marketplace and are a great way to offer open source services. If you list a paid version of your app outside of GitHub Marketplace, you must offer at least one paid plan when listing the app in GitHub Marketplace.

Free 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.

All apps need to handle events for new purchases and cancellations. Apps that only have free plans do not need to handle events for free trials, upgrades, and downgrades. For more information, see: "Using the GitHub Marketplace API in your app."

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 request verification for the app and go through financial onboarding.

There are two types of paid pricing plan:

  • 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).

You may also want to offer free trials. These provide free, 14-day 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 paid plan on a Marketplace listing that includes free trials. However, customers cannot create more than one free trial per 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.

For more information, see: "Handling new purchases and free trials."

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.