---
title: MetaobjectHandleInput - GraphQL Admin
description: The input fields for retrieving a metaobject by handle.
api_version: 2026-07
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/MetaobjectHandleInput
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/MetaobjectHandleInput.md
api_name: admin
api_type: graphql
type: input-object
---

# Metaobject​Handle​Input

input\_object

The input fields for retrieving a metaobject by handle.

## Fields

* handle

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

  non-null

  The handle of the metaobject to create or update.

* type

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

  non-null

  The type of the metaobject. Must match an existing metaobject definition type.

***

## Mutations using this input

* [metaobject​Upsert.handle](https://shopify.dev/docs/api/admin-graphql/latest/mutations/metaobjectUpsert#arguments-handle)

  ARGUMENT

***

## Map

### Mutations using this input

* [metaobject​Upsert.handle](https://shopify.dev/docs/api/admin-graphql/latest/mutations/metaobjectUpsert#arguments-handle)