---
title: PrivateMetafieldInput - GraphQL Admin
description: The input fields for a private metafield.
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/PrivateMetafieldInput
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/PrivateMetafieldInput.txt
---

# Private​Metafield​Input

input\_object

The input fields for a private metafield.

## Fields

* key

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

  non-null

  The key of the private metafield.

* namespace

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

  non-null

  The namespace of the private metafield.

* owner

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

  The resource that owns the metafield. If the field is blank, then the `Shop` resource owns the metafield.

* value​Input

  [Private​Metafield​Value​Input!](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/PrivateMetafieldValueInput)

  required

  The `value` and `valueType` of the private metafield, wrapped in a `ValueInput` object.

***

## Mutations using this input

* [private​Metafield​Upsert.​input](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/privateMetafieldUpsert#argument-input)

  MUTATION

  Deprecated

***

## Input objects using this input

* [Collection​Input.​private​Metafields](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/CollectionInput#field-privateMetafields)

  INPUT OBJECT

  The input fields required to create a collection.

* [Customer​Input.​private​Metafields](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/CustomerInput#field-privateMetafields)

  INPUT OBJECT

  The input fields and values to use when creating or updating a customer.

* [Draft​Order​Input.​private​Metafields](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/DraftOrderInput#field-privateMetafields)

  INPUT OBJECT

  The input fields used to create or update a draft order.

* [Product​Variants​Bulk​Input.​private​Metafields](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/ProductVariantsBulkInput#field-privateMetafields)

  INPUT OBJECT

  The input fields for specifying a product variant to create as part of a variant bulk mutation.

***

## Map

### Input objects using this input

* [Collection​Input.privateMetafields](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/CollectionInput#field-privateMetafields)
* [Customer​Input.privateMetafields](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/CustomerInput#field-privateMetafields)
* [Draft​Order​Input.privateMetafields](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/DraftOrderInput#field-privateMetafields)
* [Product​Variants​Bulk​Input.privateMetafields](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/ProductVariantsBulkInput#field-privateMetafields)