---
title: MetafieldNamespace - Shop Partners API
description: |-
  A MetafieldNamespace is a Permissible type. It is managed by a Client and defines a group of Custom
  Data primitives and permissions. Control and access of a MetafieldNamespace is determined by AccessGrants
  that link the Namespace to Clients or other Namespaces.
api_version: unstable latest
source_url:
  html: https://shopify.dev/docs/api/shop-partners/latest/objects/MetafieldNamespace
  md: https://shopify.dev/docs/api/shop-partners/latest/objects/MetafieldNamespace.md
---

# Metafield​Namespace

object

A MetafieldNamespace is a Permissible type. It is managed by a Client and defines a group of Custom Data primitives and permissions. Control and access of a MetafieldNamespace is determined by AccessGrants that link the Namespace to Clients or other Namespaces.

## Fields

* access

  [Custom​Data​Access​Type](https://shopify.dev/docs/api/shop-partners/latest/objects/CustomDataAccessType)

  List of the active policies associated with this Namespace. Policies represent ownership of the Namespace and can be granted to Clients and other Namespaces.

* description

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

  Developer facing description.

* key

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

  non-null

  Developer facing identifier for the resource.

* name

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

  Developer facing display name.

* namespace

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

  Developer facing path to identifier for the resource.

* uuid

  [ID!](https://shopify.dev/docs/api/shop-partners/latest/scalars/ID)

  non-null

  Internal identifier for the resource.

***

## Map

No referencing types

***

## Mutations

* [metafield​Namespace​Create](https://shopify.dev/docs/api/shop-partners/latest/mutations/metafieldNamespaceCreate)

  mutation

  Create a new MetafieldNamespace.

  Every client has their own implicit, reserved namespace; however, Namespaces allow sharing groups of Metafield Primitives and Access Grants together. Creating new Namespaces requires the client to have additional scope and is not available to all clients.

  * namespace

    [Metafield​Namespace​Create​Input!](https://shopify.dev/docs/api/shop-partners/latest/input-objects/MetafieldNamespaceCreateInput)

    required

    ### Arguments

  ***

* [metafield​Namespace​Delete](https://shopify.dev/docs/api/shop-partners/latest/mutations/metafieldNamespaceDelete)

  mutation

  Destroy a Namespace and remove any shared Access. MetafieldDefinitions shared to the Namespace will not be deleted, but their association with the namespace will be removed.

  * identifier

    [Custom​Data​Key​Pair​Input!](https://shopify.dev/docs/api/shop-partners/latest/input-objects/CustomDataKeyPairInput)

    required

    ### Arguments

    This argument accepts an object that consists of a `key` and an optional `namespace`. The `key` is a mandatory attribute that represents a specific element within a namespace. The `namespace` attribute, if provided, should be a period-delimited string representing the hierarchical path to the desired namespace. This is applicable in cases where the desired namespace is nested within other namespaces. In the absence of a provided `namespace`, the system will default to the client's implicit, reserved namespace.

  ***

* [metafield​Namespace​Update](https://shopify.dev/docs/api/shop-partners/latest/mutations/metafieldNamespaceUpdate)

  mutation

  Update a MetafieldNamespace by changing its key, name, description, capabilities, or access.

  * namespace

    [Metafield​Namespace​Update​Input!](https://shopify.dev/docs/api/shop-partners/latest/input-objects/MetafieldNamespaceUpdateInput)

    required

    ### Arguments

  ***

***

## MetafieldNamespace Mutations

### Mutated by

* [metafield​Namespace​Create](https://shopify.dev/docs/api/shop-partners/latest/mutations/metafieldNamespaceCreate)
* [metafield​Namespace​Delete](https://shopify.dev/docs/api/shop-partners/latest/mutations/metafieldNamespaceDelete)
* [metafield​Namespace​Update](https://shopify.dev/docs/api/shop-partners/latest/mutations/metafieldNamespaceUpdate)

***

## Interfaces

* [Custom​Data​Permissible](https://shopify.dev/docs/api/shop-partners/latest/interfaces/CustomDataPermissible)

  interface

***

## MetafieldNamespace Implements

### Implements

* [Custom​Data​Permissible](https://shopify.dev/docs/api/shop-partners/latest/interfaces/CustomDataPermissible)