Installing an app in your organization

You can install apps from GitHub Marketplace to use in your organization.

Note: This article applies to installing and purchasing apps from GitHub Marketplace only. For more information on apps purchased from integrators, see "About integrations."

Tip: If an app requires organization-level access, then only an organization owner can purchase, install, or cancel the app, and manage app billing for the organization. If the app doesn't require organization-level access, then a repository administrator can install and uninstall the app.

If you choose a paid plan, you'll pay for your app subscription on your organization's current billing date using your organization's existing payment method.

If you choose a paid plan with a free trial, you can cancel at any time during your trial period without being charged, but you will automatically lose access to the app. Your paid subscription will start at the end of the 14-day trial. For more information, see "About billing for GitHub Marketplace."

Installing a GitHub App in your organization

  1. At the top of any page, click Marketplace. Marketplace link in the global navigation menu at the top of every page
  2. Browse to the app you'd like to install, then click on the app's name.
  3. On the app's page, under "Pricing and setup," click on the pricing plan you'd like to use. List of the app's available pricing plans
  4. Click Install it for free, Buy with GitHub, or Try free for 14 days. Buy with GitHub button
  5. Under "Billing information," use the Switch billing account drop-down menu, and choose the organization in which you'd like to install the app. Drop-down menu to switch the billing account, and your chosen organization's name and avatar
  6. If you chose a paid plan, review your payment method.
    • To change the existing payment method on file for the organization, click Edit..., then complete the form to add a new payment method. After you successfully add a new payment method, you will automatically return to the order page. Link to add a payment method to your organization
    • If there isn't a payment method on file for the organization, click Add a Payment Method, then complete the form to add a credit card or PayPal account. Link to add a payment method to your organization
  7. Click Complete order and begin installation. Complete order and begin installation button
  8. If the app requires access to repositories, decide whether to give the app access to all of your repositories or to certain repositories, then select All repositories or Only select repositories. Radio buttons with options to install an app on all of your repositories or certain repositories
  9. If you chose to give the app access to limited repositories instead of all of your repositories, type the name of each repository you'd like to give the app access to, then click on the repository name to select it. Field to select repositories you'd like to give to app access to
  10. Review the app's access permissions, then click Install.

Installing an OAuth App in your organization

If you belong to any organizations that enforce SAML single sign-on, you may be prompted to authenticate through your identity provider before you can authorize an OAuth App. For more information about SAML, see "About authentication with SAML single sign-on."

  1. At the top of any page, click Marketplace. Marketplace link in the global navigation menu at the top of every page
  2. Browse to the app you'd like to install, then click on the app's name.
  3. On the app's page, under "Pricing and setup," click on the pricing plan you'd like to use. List of the app's available pricing plans
  4. Click Install it for free, Buy with GitHub, or Try free for 14 days. Buy with GitHub button
  5. Under "Billing information," use the Switch billing account drop-down menu, and choose the organization in which you'd like to install the app. Drop-down menu to switch the billing account, and your chosen organization's name and avatar
  6. If you chose a paid plan, review your payment method.
    • To change the existing payment method on file for the organization, click Edit..., then complete the form to add a new payment method. After you successfully add a new payment method, you will automatically return to the order page. Link to add a payment method to your organization
    • If there isn't a payment method on file for the organization, click Add a Payment Method, then complete the form to add a credit card or PayPal account. Link to add a payment method to your organization
  7. Click Complete order and begin installation. Complete order and begin installation button
  8. Review the information about the app's access to your personal account, organizations, and data, then click Authorize application.

Further reading

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.