---
title: appByHandle - GraphQL Admin
description: >-
  Retrieves an app by its unique handle. The handle is a URL-friendly identifier
  for the app.


  Returns the
  [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) if
  found, or `null` if no app exists with the specified handle.
api_version: 2025-10
api_name: admin
type: query
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/queries/appByHandle'
  md: 'https://shopify.dev/docs/api/admin-graphql/latest/queries/appByHandle.md'
---

# app​By​Handle

query

Retrieves an app by its unique handle. The handle is a URL-friendly identifier for the app.

Returns the [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) if found, or `null` if no app exists with the specified handle.

## Arguments

* handle

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

  required

  Handle of the App.

***

## Possible returns

* App

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

  A Shopify application that extends store functionality. Apps integrate with Shopify through APIs to add features, automate workflows, or connect external services.

  Provides metadata about the app including its developer information and listing details in the Shopify App Store. Use the [`installation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App#field-App.fields.installation) field to determine if the app is currently installed on the shop and access installation-specific details like granted [`AccessScope`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AccessScope) objects. Check [`failedRequirements`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App#field-App.fields.failedRequirements) before installation to identify any prerequisites that must be met.

***

## Examples

* ### appByHandle reference

## Query Reference

```graphql
{
  appByHandle(handle) {
    # appByHandle fields
  }
}
```