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

# Metaobject​Handle​Input

input\_object

The input fields for retrieving a metaobject by handle.

## Fields

* handle

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

  non-null

  The handle of the metaobject to create or update.

* type

  [String!](https://shopify.dev/docs/api/admin-graphql/2024-10/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/2024-10/mutations/metaobjectUpsert#argument-handle)

  MUTATION

***

## Map

### Mutations using this input

* <\~>[metaobject​Upsert.handle](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/metaobjectUpsert#argument-handle)