Setting pricing plans for your listing

When you list your app on GitHub Marketplace, you can choose to provide your app as a free service or sell your app. If you plan to sell your app, you can create different pricing plans for different feature tiers.

In this article

About setting pricing plans

If you want to sell an app on GitHub Marketplace, you need to request verification when you publish the listing for your app. During the verification process, an onboarding expert checks the organization's identity and security settings. The onboarding expert will also take the organization through financial onboarding. For more information, see: "Requirements for listing an app on GitHub Marketplace."

If you want to sell an app that's owned by your user account, first you'll need to transfer the app to an organization, and then request verification for a listing created by the organization. For information on how to do this, see: "Submitting your listing for publication."

GitHub Marketplace offers several different types of pricing plan. For detailed information, see "Pricing plans for GitHub Marketplace."

About saving pricing plans

You can save pricing plans in a draft or published state. If you haven't submitted your GitHub Marketplace listing for approval, a published plan will function in the same way as a draft plan until your listing is approved and shown on GitHub Marketplace. Draft plans allow you to create and save new pricing plans without making them available on your GitHub Marketplace listing page. Once you publish a pricing plan on a published listing, it's available for customers to purchase immediately. You can publish up to 10 pricing plans.

For guidelines on billing customers, see "Billing customers."

Creating pricing plans

To create a pricing plan for your GitHub Marketplace listing, click Plans and pricing in the left sidebar of your GitHub Marketplace listing page. For more information, see "Creating a draft GitHub Marketplace listing."

When you click New draft plan, you'll see a form that allows you to customize your pricing plan. You'll need to configure the following fields to create a pricing plan:

  • Plan name - Your pricing plan's name will appear on your GitHub Marketplace app's landing page. You can customize the name of your pricing plan to align with the plan's resources, the size of the company that will use the plan, or anything you'd like.

  • Pricing models - There are three types of pricing plan: free, flat-rate, and per-unit. All plans require you to process new purchase and cancellation events from the marketplace API. In addition, for paid plans:

    • You must set a price for both monthly and yearly subscriptions in US dollars.
    • Your app must process plan change events.
    • You must request verification to publish a listing with a paid plan.
    • You can offer your app for free for 14 days as a free trial. Free trials automatically convert to a paid subscription after 14 days, unless the customer cancels before the free trial expires. Select "Enable 14 day free trial for this plan" to offer a free trial.

    For detailed information, see "Pricing plans for GitHub Marketplace apps" and "Using the GitHub Marketplace API in your app."

  • Available for - GitHub Marketplace pricing plans can apply to Personal and organization accounts, Personal accounts only, or Organization accounts only. For example, if your pricing plan is per-unit and provides multiple seats, you would select Organization accounts only because there is no way to assign seats to people in an organization from a personal account.

  • Short description - Write a brief summary of the details of the pricing plan. The description might include the type of customer the plan is intended for or the resources the plan includes.

  • Bullets - You can write up to four bullets that include more details about your pricing plan. The bullets might include the use cases of your app or list more detailed information about the resources or features included in the 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.

Changing a GitHub Marketplace listing's pricing plan

If a pricing plan for your GitHub Marketplace listing is no longer needed, or if you need to adjust pricing details, you can remove it.

Button to remove your pricing plan

Once you publish a pricing plan for an app that is already listed in GitHub Marketplace, you can't make changes to the plan. Instead, you'll need to remove the pricing plan and create a new plan. Customers who already purchased the removed pricing plan will continue to use it until they opt out and move onto a new pricing plan. For more on pricing plans, see "GitHub Marketplace pricing plans."

Once you remove a pricing plan, users won't be able to purchase your app using that plan. Existing users on the removed pricing plan will continue to stay on the plan until they cancel their plan subscription.

Note: GitHub can't remove users from a removed pricing plan. You can run a campaign to encourage users to upgrade or downgrade from the removed pricing plan onto a new pricing plan.

You can disable GitHub Marketplace free trials without retiring the pricing plan, but this prevents you from initiating future free trials for that plan. If you choose to disable free trials for a pricing plan, users already signed up can complete their free trial.

After retiring a pricing plan, you can create a new pricing plan with the same name as the removed pricing plan. For instance, if you have a "Pro" pricing plan but need to change the flat rate price, you can remove the "Pro" pricing plan and create a new "Pro" pricing plan with an updated price. Users will be able to purchase the new pricing plan immediately.

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.