Listing on GitHub Marketplace

You can list verified and unverified apps on GitHub Marketplace for people to explore, purchase, and install. Unverified apps do not need to meet the "Requirements for listing an app on GitHub Marketplace" or go through the "Security review process." Unverified apps are only offered with free plans. To list paid plans, you must submit a verified app.

Steps to create a listing

Read each of these sections to guide you through creating a listing for your app:

  1. Creating a draft GitHub Marketplace listing
    Create a draft GitHub Marketplace listing for an app that you've already developed. You can use this draft listing to test your integration with the GitHub Marketplace API.

  2. Writing GitHub Marketplace listing descriptions
    Tell customers about your app by including screenshots, feature cards, and listing descriptions.

  3. Setting a GitHub Marketplace listing's pricing plans
    Create a free or paid pricing plan for your app.

  4. Configuring the GitHub Marketplace webhook
    Set up webhooks to start receiving GitHub Marketplace purchase events.

Submitting your listing

Once you've completed your app listing, you'll see two buttons that allow you to submit an unverified and verified app. The Publish without Verification Request button will not be available if you have published any paid pricing plans.

Unverified and verified request button

You can submit both an unverified and verified app. This will allow you to launch with a free version of your app. Once GitHub verifies your app, your listing will change from unverified to verified in GitHub Marketplace and GitHub will publish your new pricing plans.

Before you can submit a verified app, you'll need to integrate the GitHub Marketplace billing flows and webhook into your existing app. See Verified apps for the steps required to submit your app.

If you've met the requirements for a verified GitHub Marketplace listing and you've integrated with the GitHub Marketplace API, go ahead and submit your listing!

After you submit your listing for review, the GitHub Marketplace onboarding team will reach out to you with additional information.