---
title: MetafieldAccessGrantInput - GraphQL Admin
description: >-
  The input fields for an explicit access grant to be created or updated for the
  metafields under this definition.


  Explicit grants are
  [deprecated](https://shopify.dev/changelog/deprecating-explicit-access-grants-for-app-owned-metafields).
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/MetafieldAccessGrantInput
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/MetafieldAccessGrantInput.txt
---

# Metafield​Access​Grant​Input

input\_object

The input fields for an explicit access grant to be created or updated for the metafields under this definition.

Explicit grants are [deprecated](https://shopify.dev/changelog/deprecating-explicit-access-grants-for-app-owned-metafields).

## Fields

* access

  [Metafield​Grant​Access​Level!](https://shopify.dev/docs/api/admin-graphql/2024-10/enums/MetafieldGrantAccessLevel)

  non-null

  The level of access being granted.

* grantee

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

  non-null

  The grantee being granted access.

***

## Input objects using this input

* [Metafield​Access​Grant​Operation​Input.​create](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/MetafieldAccessGrantOperationInput#field-create)

  INPUT OBJECT

  The input fields for possible operations for modifying access grants. Exactly one option is required.

  Explicit grants are [deprecated](https://shopify.dev/changelog/deprecating-explicit-access-grants-for-app-owned-metafields).

* [Metafield​Access​Grant​Operation​Input.​update](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/MetafieldAccessGrantOperationInput#field-update)

  INPUT OBJECT

  The input fields for possible operations for modifying access grants. Exactly one option is required.

  Explicit grants are [deprecated](https://shopify.dev/changelog/deprecating-explicit-access-grants-for-app-owned-metafields).

* [Metafield​Access​Input.​grants](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/MetafieldAccessInput#field-grants)

  INPUT OBJECT

  The input fields that set access permissions for the definition's metafields.

***

## Map

### Input objects using this input

* [Metafield​Access​Grant​Operation​Input.create](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/MetafieldAccessGrantOperationInput#field-create)
* [Metafield​Access​Grant​Operation​Input.update](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/MetafieldAccessGrantOperationInput#field-update)
* [Metafield​Access​Input.grants](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/MetafieldAccessInput#field-grants)