---
title: appUninstall - GraphQL Admin
description: |-
  Uninstalls an app from a shop.

  This mutation can only be used by apps to uninstall themselves. Apps with the `apps` access scope can uninstall other apps by providing the app ID in the input parameter.

  Use the `appUninstall` mutation to programmatically remove apps from shops.

  The mutation returns the uninstalled app and any errors that occurred during the uninstallation process.

  Learn more about [app lifecycle management](https://shopify.dev/docs/apps/build/authentication-authorization/app-installation/uninstall-app-api-request).
api_version: 2025-07
api_name: admin
type: mutation
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/appuninstall
  md: https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/appuninstall.md
---

# app​Uninstall

mutation

Requires This mutation can only be used by apps to uninstall themselves.

Uninstalls an app from a shop.

This mutation can only be used by apps to uninstall themselves. Apps with the `apps` access scope can uninstall other apps by providing the app ID in the input parameter.

Use the `appUninstall` mutation to programmatically remove apps from shops.

The mutation returns the uninstalled app and any errors that occurred during the uninstallation process.

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

## App​Uninstall​Payload returns

* app

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

  The uninstalled app.

* user​Errors

  [\[App​Uninstall​App​Uninstall​Error!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/AppUninstallAppUninstallError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### appUninstall reference

## Mutation Reference

```graphql
mutation appUninstall {
  appUninstall {
    app {
      # App fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

```json
{}
```

##### Variables

```
{}
```