---
title: AppInstallation - GraphQL Admin
description: Represents an installed application on a shop.
api_version: 2025-10
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

Represents an installed application on a shop.

## Fields

* access​Scopes

  [\[Access​Scope!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/AccessScope)

  non-null

  The access scopes granted to the application by a merchant during installation.

* active​Subscriptions

  [\[App​Subscription!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscription)

  non-null

  The active application subscriptions billed to the shop on a recurring basis.

* all​Subscriptions

  [App​Subscription​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/AppSubscriptionConnection)

  non-null

  All subscriptions created for a shop.

* app

  [App!](https://shopify.dev/docs/api/admin-graphql/latest/objects/App)

  non-null

  Application which is installed.

* credits

  [App​Credit​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/AppCreditConnection)

  non-null

  Credits that can be used towards future app purchases.

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  non-null

  A globally-unique ID.

* launch​Url

  [URL!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/URL)

  non-null

  The URL to launch the application.

* metafield

  [Metafield](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metafield)

  A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information.

* metafields

  [Metafield​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/MetafieldConnection)

  non-null

  A list of [custom fields](https://shopify.dev/docs/apps/build/custom-data) that a merchant associates with a Shopify resource.

* one​Time​Purchases

  [App​Purchase​One​Time​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/AppPurchaseOneTimeConnection)

  non-null

  One-time purchases to a shop.

* publication

  [Publication](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication)

  The publication associated with the installed application.

* revenue​Attribution​Records

  [App​Revenue​Attribution​Record​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/AppRevenueAttributionRecordConnection)

  non-null

  The records that track the externally-captured revenue for the app. The records are used for revenue attribution purposes.

* uninstall​Url

  [URL](https://shopify.dev/docs/api/admin-graphql/latest/scalars/URL)

  The URL to uninstall the application.

### Deprecated fields

* channel

  [Channel](https://shopify.dev/docs/api/admin-graphql/latest/objects/Channel)

  Deprecated

* subscriptions

  [\[App​Subscription!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscription)

  non-nullDeprecated

***

## 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

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

  query

  Look up an app installation by ID or return the app installation for the currently authenticated app.

  Use the `appInstallation` query to:

  * Fetch current access scope permissions for your app
  * Retrieve active subscription details and billing status
  * Validate installation state during app initialization
  * Display installation-specific information in your app interface

  Learn more about [app installation](https://shopify.dev/docs/apps/build/authentication-authorization/app-installation).

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

  query

  A list of app installations. To use this query, your app needs the `read_apps` access scope, which can only be requested after you're granted approval from [Shopify Support](https://partners.shopify.com/current/support/). This scope can be granted to custom and public apps.

  Returns a paginated connection of `AppInstallation` objects across multiple stores.

  Learn more about [app installation](https://shopify.dev/docs/apps/build/authentication-authorization/app-installation).

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

  query

  Return the AppInstallation for the currently authenticated App.

***

## \<?>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/AppInstallationConnection)
* \<?>[current​App​Installation](https://shopify.dev/docs/api/admin-graphql/latest/queries/AppInstallation)

***

## Interfaces

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

    interface

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

    interface

***

## ||-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)