You can only create draft listings for apps that are public. Before creating your draft listing, you can read the following guidelines for writing and configuring settings in your GitHub Marketplace listing:
- Writing GitHub Marketplace listing descriptions
- Setting a GitHub Marketplace listing's pricing plan
- Configuring the GitHub Marketplace Webhook
To create a GitHub Marketplace listing:
In the upper-right corner of any page, click your profile photo, then click Settings.
In the left sidebar, click Developer settings.
In the left sidebar, click either OAuth Apps or GitHub Apps depending on the app you're adding to GitHub Marketplace.
Note: You can also add a listing by navigating to https://github.com/marketplace/new, viewing your available apps, and clicking Create draft listing.
Select the app you'd like to add to GitHub Marketplace.
Scroll down to the Marketplace section and click Edit Marketplace listing. The Marketplace section is only visible if you allowed your app to be installed by any user or organization when registering the app. For more information, see the list of Marketplace requirements.
Once you've created a new draft listing, you'll see an overview of the sections that you'll need to visit before your GitHub Marketplace listing will be complete.
Note: In the "Contact info" section of your listing, we recommend using individual email addresses, rather than group emails addresses like email@example.com. GitHub will use these email addresses to contact you about updates to GitHub Marketplace that might affect your listing, new feature releases, marketing opportunities, payouts, and information on conferences and sponsorships.
Once you've created a GitHub Marketplace draft listing, you can come back to modify information in your listing anytime. If your app is already approved and in GitHub Marketplace, you can edit the information and images in your listing, but you will not be able to change existing published pricing plans. See "Setting a GitHub Marketplace listing's pricing plan."
Once you've completed your GitHub Marketplace listing, you can submit your listing for review from the Overview page. You'll need to read and accept the "GitHub Marketplace Developer Agreement," and then you can click Submit for review. After you submit your app for review, the GitHub Marketplace onboarding team will contact you with additional information about the onboarding process. You can learn more about the onboarding and security review process in "Getting started with GitHub Marketplace."
If you no longer want to list your app in GitHub Marketplace, contact firstname.lastname@example.org to remove your listing.