docs/content/developers/github-marketplace/setting-pricing-plans-for-your-listing.md

title	intro	redirect_from	versions
Setting pricing plans for your listing	When you list your app on {% data variables.product.prodname_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.	[/apps/adding-integrations/managing-pricing-and-payments-for-a-github-marketplace-listing/setting-a-github-marketplace-listing-s-pricing-plan/ /apps/marketplace/managing-pricing-and-payments-for-a-github-marketplace-listing/setting-a-github-marketplace-listing-s-pricing-plan/ /apps/marketplace/pricing-payments-and-free-trials/setting-a-github-marketplace-listing-s-pricing-plan/ /apps/adding-integrations/managing-pricing-and-payments-for-a-github-marketplace-listing/about-github-marketplace-pricing-plans/ /apps/marketplace/managing-pricing-and-payments-for-a-github-marketplace-listing/about-github-marketplace-pricing-plans/ /apps/marketplace/pricing-payments-and-free-trials/about-github-marketplace-pricing-plans/ /apps/adding-integrations/managing-pricing-and-payments-for-a-github-marketplace-listing/changing-a-github-marketplace-listing-s-pricing-plan/ /apps/marketplace/managing-pricing-and-payments-for-a-github-marketplace-listing/changing-a-github-marketplace-listing-s-pricing-plan/ /apps/marketplace/managing-github-marketplace-listings/changing-a-github-marketplace-listing-s-pricing-plan/ /apps/marketplace/listing-on-github-marketplace/setting-a-github-marketplace-listing-s-pricing-plan/ /marketplace/listing-on-github-marketplace/setting-a-github-marketplace-listing-s-pricing-plan]	[{free-pro-team *}]

About setting pricing plans

{% data variables.product.prodname_marketplace %} offers several different types of pricing plans. For detailed information, see "Pricing plans for {% data variables.product.prodname_marketplace %}."

To offer a paid plan for your app, your app must be owned by an organization that has completed the publisher verification process and met certain criteria. For more information, see "Applying for publisher verification for your organization" and "Requirements for listing an app on {% data variables.product.prodname_marketplace %}."

If your app is already published with a paid plan and you're a verified publisher, then you can publish a new paid plan from the "Edit a pricing plan" page in your Marketplace app listing settings.

About saving pricing plans

You can save pricing plans in a draft or published state. If you haven't submitted your {% data variables.product.prodname_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 {% data variables.product.prodname_marketplace %}. Draft plans allow you to create and save new pricing plans without making them available on your {% data variables.product.prodname_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 {% data variables.product.prodname_marketplace %} listing, click Plans and pricing in the left sidebar of your {% data variables.product.prodname_marketplace %} listing page. For more information, see "Creating a draft {% data variables.product.prodname_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 {% data variables.product.prodname_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.
  • {% data reusables.marketplace.marketplace-pricing-free-trials %}

  For detailed information, see "Pricing plans for {% data variables.product.prodname_marketplace %} apps" and "Using the {% data variables.product.prodname_marketplace %} API in your app."

• Available for - {% data variables.product.prodname_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.

{% data reusables.marketplace.free-plan-note %}

Changing a {% data variables.product.prodname_marketplace %} listing's pricing plan

If a pricing plan for your {% data variables.product.prodname_marketplace %} listing is no longer needed, or if you need to adjust pricing details, you can remove it.

Once you publish a pricing plan for an app that is already listed in {% data variables.product.prodname_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 "{% data variables.product.prodname_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 %}

Note: {% data variables.product.product_name %} 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.

{% endnote %}

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.