1
0
mirror of synced 2025-12-30 12:02:01 -05:00
Files
docs/content/developers/github-marketplace/about-github-marketplace.md

5.3 KiB

title, intro, redirect_from, versions
title intro redirect_from versions
About GitHub Marketplace Learn about {% data variables.product.prodname_marketplace %} where you can share your apps and actions publicly with all {% data variables.product.product_name %} users.
/apps/marketplace/getting-started/
/marketplace/getting-started
free-pro-team
*

{% data variables.product.prodname_marketplace %} connects you to developers who want to extend and improve their {% data variables.product.prodname_dotcom %} workflows. You can list free and paid tools for developers to use in {% data variables.product.prodname_marketplace %}. {% data variables.product.prodname_marketplace %} offers developers two types of tools: {% data variables.product.prodname_actions %} and Apps, and each tool requires different steps for adding it to {% data variables.product.prodname_marketplace %}.

GitHub Actions

{% data reusables.actions.actions-not-verified %}

To learn about publishing {% data variables.product.prodname_actions %} in {% data variables.product.prodname_marketplace %}, see "Publishing actions in GitHub Marketplace."

Apps

Anyone can share their apps with other users on {% data variables.product.prodname_marketplace %} but only listings that are verified by {% data variables.product.company_short %} can include paid plans. For more information, see "About verified creators."

If you're interested in creating an app for {% data variables.product.prodname_marketplace %}, but you're new to {% data variables.product.prodname_github_apps %} or {% data variables.product.prodname_oauth_app %}s, see "Building {% data variables.product.prodname_github_apps %}" or "Building {% data variables.product.prodname_oauth_app %}s."

{% data reusables.marketplace.github_apps_preferred %}, although you can list both OAuth and {% data variables.product.prodname_github_app %}s in {% data variables.product.prodname_marketplace %}. For more information, see "Differences between {% data variables.product.prodname_github_apps %} and {% data variables.product.prodname_oauth_app %}s" and "Migrating {% data variables.product.prodname_oauth_app %}s to {% data variables.product.prodname_github_apps %}."

If you have questions about {% data variables.product.prodname_marketplace %}, please contact {% data variables.contact.contact_support %} directly.

Publishing an app to {% data variables.product.prodname_marketplace %}

When you have finished creating your app, you can share it with other users by publishing it to {% data variables.product.prodname_marketplace %}. In summary, the process is:

  1. Review your app carefully to ensure that it will behave as expected in other repositories and that it follows best practice guidelines. For more information, see "Security best practices for apps" and "Requirements for listing an app."

  2. Add webhook events to the app to track user billing requests. For more information about the {% data variables.product.prodname_marketplace %} API, webhook events, and billing requests, see "Using the {% data variables.product.prodname_marketplace %} API in your app."

  3. Create a draft {% data variables.product.prodname_marketplace %} listing. For more information, see "Drafting a listing for your app."

  4. Add a pricing plan. For more information, see "Setting pricing plans for your listing."

  5. Check whether your app meets the requirements for listing on {% data variables.product.prodname_marketplace %} as a free or a paid app. For more information, see "Requirements for listing an app."

  6. Read and accept the terms of the "{% data variables.product.prodname_marketplace %} Developer Agreement."

  7. Submit your listing for publication in {% data variables.product.prodname_marketplace %}, requesting verification if you want to sell the app. For more information, see "Submitting your listing for publication."

An onboarding expert will contact you with any questions or further steps. For example, if you have added a paid plan, you will need to complete the verification process and complete financial onboarding. As soon as your listing is approved the app is published to {% data variables.product.prodname_marketplace %}.

Seeing how your app is performing

You can access metrics and transactions for your listing. For more information, see: