About Marketplace
This article applies to installing and purchasing Apps from Marketplace. For more information on installing Apps from a source other than Marketplace, see Installing a App from a third party.
Note
Apps from Marketplace are not currently available on GHE.com.
If you install a App on your organization account and you choose a paid plan, you will 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 Marketplace.
For more information about installing an OAuth app instead of a App from Marketplace, see Installing an OAuth app in your organization.
About installing Apps
In order to use a App on your repositories or organization, you must install the app on your organization or personal account. You can install the same App on multiple accounts. For example, if you install the app on your personal account and on a few organizations that you own, you'll be able to use the app on your personal repositories, on the organizations where you installed the app, and on repositories owned by those organizations.
When you install an app, you grant the app permission to access the organization and repository resources that it requested. During the installation process, will tell you which permissions the App requested. For more information about the REST API requests the App can make with those permissions, see Permissions required for Apps.
When you install an app, you will also choose which repositories to grant the App access to.
Before installing a App, you should ensure you trust the owner of the App. You should also review the permissions that the App is requesting and make sure you are comfortable granting those permissions. For more information about the REST API requests the App can make with those permissions, see Permissions required for Apps.
There is no limit to how many apps you can install.
Difference between installation and authorization
After you install a App, you may also be asked to authorize the app.
When you install a App on your account or organization, you grant the app permission to access the organization and repository resources that it requested. You also specify which repositories the app can access. During the installation process, the App will indicate which repository and organization permissions you are granting. For more information about what different permissions enable a App to do, see Choosing permissions for a App.
For example, you might grant the App permission to read repository metadata and write issues, and you might grant the App access to all of your repositories.
When you authorize a App, you grant the app access to your account, based on the account permissions the app requested. During the authorization process, the app will indicate which resources the app can access on your account. When you authorize a App, you also grant the app permission to act on your behalf.
For example, you might grant the App permission to read your email addresses and write gists.
You can install a App without authorizing the app. Similarly, you can authorize the app without installing the app.
For more information about authorizing Apps, see Authorizing Apps.
Requirements to install a App on an organization
Organization owners can install Apps on their organization.
For enterprises that pay by credit card, enterprise owners who are also organization owners can install Apps on organizations within their enterprise.
Admins of repositories that are owned by an organization can also install Apps on the organization if they only grant the app access to repositories that they are an admin of and if the app does not request any organization permissions or the "repository administration" permission. Organization owners can prevent outside collaborators who are repository admins from installing Apps.
The "app manager" role in an organization does not give a person the ability to install a App in the organization. For more information, see About App managers.
For enterprise managed user accounts, only enterprise owners can purchase and install a paid App for an organization in the enterprise. Enterprise members cannot purchase a paid App. Organization owners with an enterprise managed user account can still install a free App.
Installing a App in your organization
To open Marketplace, in the top-left corner of , select , then click Marketplace.
Browse to the app you'd like to install, then click on the app's name.
On the app's page, under "Pricing and setup," click the pricing plan you'd like to use.
Click Install it for free, Buy with , or Try free for 14 days.
Choose an installation organization for the app. Depending on your organization's terms of service, this process will be slightly different.
- If you have given permission to collect name and address information for your organization, in the "Billing information" section, select the Switch billing account dropdown menu, then click the organization in which you'd like to install the app.
- Otherwise, under "Review your order," select the Account dropdown menu, then click the organization in which you'd like to install the app.
Note
If your organization uses SAML SSO and you do not see your organization listed, you may need to start an active SAML session for your organization. For more information, see SAML and Apps.
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.
- 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.
Click Complete order and begin installation.
If the app requires access to repositories, select All repositories or Only select repositories.
If the app creates any repositories, the app will automatically be granted access to those repositories as well.
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.
Review the app's access permissions, then click Install.
