# Install an app

Learn how to install apps in Hygraph. This document covers installing your app, app permission authorization, and app configuration.

This document will walk you through the process of installing an app on **Hygraph**.

**Warning:**

The app installation process is similar whether you created the app or it was shared with you. If the app was shared with you or you're installing it from our [Marketplace](https://hygraph.com/marketplace), please start from [Step 2](https://hygraph.com/docs/app-framework/app-installation#2-install-your-app).

**Apps are environment specific**. This means their configuration is applied per environment. Take this into consideration if you're working with a project using more than one environment.

## 1. Navigate to your apps

![Your apps](https://hygraph.com/images/docs/app-framework/app-installation/your-apps-menu.png)

If you're a developer and [created an app](https://hygraph.com/docs/app-framework/first-steps/overview), now you need to install it in order to be able to use it.

Navigate to **You apps** at the top of the project directory, or to **User menu > Your apps** in your Hygraph project, find the card of the app you want to install, then click **Install**.

## 2. Install your app

Whether you got here from step 1, a marketplace link, or a shared app link, the next step is to install the app.

![App installation- DeepL example](https://hygraph.com/images/docs/app-framework/app-installation/app-installation.png)

To install the app, select a `Project` and an `Environment` from the dropdowns, then click `Install app`.

## 3. App permission authorization

The `App permission authorization` screen will display as a result, where the app requests your authorization to access your project. This screen lists the permissions you'll be granting.

![App permission authorization screen](https://hygraph.com/images/docs/app-framework/app-installation/app-permission-authorization.png)

You must click on the `Authorize app` button to proceed. **You can revoke access at any time by deleting the app.**

## 4. Configure your app

Authorizing permissions redirects you to the app configuration screen on your project. 

The last step is filling in the required data in the app configuration screen, if any.

The configuration screen will look different and may require different information depending on the app.

**Warning:**

**If you're installing an app from our marketplace**, the required information will come from your account in the app you're integrating with, and will be detailed in the integration guide we provide.

**If you're installing a private app that was shared with you**, this information should be provided by the developer.

After you've filled in the required information, save it to finish the process. You'll be able to find the installed app in the **Apps** tab of your project, under **Installed apps**.

## Resources

- [App Framework:](https://hygraph.com/docs/app-framework) Overview to our **App Framework**, which extends **Hygraph** capabilities, offering the possibility of creating your own custom apps and sharing them with other users.
- [Register an app:](https://hygraph.com/docs/app-framework/register-an-app) Documentation for developers on how to register an app on the **Hygraph** platform.
- [Using app tokens:](https://hygraph.com/docs/app-framework/app-tokens) How to exchange a setup code for an app token and use it to authenticate Hygraph API requests.
- [Delete an app:](https://hygraph.com/docs/app-framework/delete-an-app) Documentation for developers on how to delete an app you have created.
- [First steps:](https://hygraph.com/docs/app-framework/first-steps/overview) Comprehensive step-by-step guide on how to develop an app with custom field and sidebar elements.
- [Next.js starter:](https://hygraph.com/docs/app-framework/quick-starters/nextjs) Document that guides you through the process of developing an app with a custom field using our `Next.js` starter.
- [API Reference:](https://hygraph.com/docs/app-framework/api-reference/api-reference-common) Our App Framework API Reference.