---
title: AppInstallation - GraphQL Admin
description: >-
  An app installed on a shop. Each installation tracks the permissions granted
  to the app through
  [`AccessScope`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AccessScope)
  objects, along with billing subscriptions and
  [`Metafield`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metafield)
  objects.


  The installation provides metafields that only the owning
  [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) can
  access. These metafields store app-specific configuration that merchants and
  other apps can't modify. The installation also provides URLs for launching and
  uninstalling the app, along with any active
  [`AppSubscription`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscription)
  objects or
  [`AppPurchaseOneTime`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppPurchaseOneTime)
  purchases.
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/AppInstallation'
  md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/AppInstallation.md'
---

# App​Installation

object

An app installed on a shop. Each installation tracks the permissions granted to the app through [`AccessScope`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AccessScope) objects, along with billing subscriptions and [`Metafield`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metafield) objects.

The installation provides metafields that only the owning [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) can access. These metafields store app-specific configuration that merchants and other apps can't modify. The installation also provides URLs for launching and uninstalling the app, along with any active [`AppSubscription`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscription) objects or [`AppPurchaseOneTime`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppPurchaseOneTime) purchases.

## Fields

* accessScopes
* activeSubscriptions
* allSubscriptions
* app
* credits
* id
* launchUrl
* metafield
* metafields
* oneTimePurchases
* publication
* revenueAttributionRecords
* uninstallUrl

### Deprecated fields

* channel: deprecated
* subscriptions: deprecated

***

## Map

### Fields and connections with this object

* [App.installation](https://shopify.dev/docs/api/admin-graphql/latest/objects/App#field-App.fields.installation)
* [AppInstallationConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/AppInstallationConnection#returns-nodes)
* [AppInstallationEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppInstallationEdge#field-AppInstallationEdge.fields.node)

### Possible type in

* [Metafield​Referencer](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReferencer)

***

## Queries

* appInstallation
* appInstallations
* currentAppInstallation

***

## AppInstallation Queries

### Queried by

* [app​Installation](https://shopify.dev/docs/api/admin-graphql/latest/queries/appInstallation)
* [app​Installations](https://shopify.dev/docs/api/admin-graphql/latest/queries/appInstallations)
* [current​App​Installation](https://shopify.dev/docs/api/admin-graphql/latest/queries/currentAppInstallation)

***

## Interfaces

* HasMetafields
* Node

***

## AppInstallation Implements

### Implements

* [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafields)
* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)