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

# Metaobject​Upsert​Input

input\_object

The input fields for upserting a metaobject.

## Fields

* capabilities

  [Metaobject​Capability​Data​Input](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/MetaobjectCapabilityDataInput)

  Capabilities for the metaobject.

* fields

  [\[Metaobject​Field​Input!\]](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/MetaobjectFieldInput)

  Values for fields. These are mapped by key to fields of the metaobject definition.

* handle

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

  The handle of the metaobject.

***

## Mutations using this input

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

  ARGUMENT

***

## Map

### Mutations using this input

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