---
title: metafieldNamespaceCreate - Shop Partners API
description: |-
  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.
api_version: unstable latest
source_url:
  html: https://shopify.dev/docs/api/shop-partners/latest/mutations/metafieldNamespaceCreate
  md: https://shopify.dev/docs/api/shop-partners/latest/mutations/metafieldNamespaceCreate.md
---

# metafield​Namespace​Create

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.

## Arguments

* namespace

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

  required

***

## Metafield​Namespace​Create​Payload returns

* created​Namespace

  [Metafield​Namespace](https://shopify.dev/docs/api/shop-partners/latest/objects/MetafieldNamespace)

* user​Errors

  [\[User​Error!\]!](https://shopify.dev/docs/api/shop-partners/latest/objects/UserError)

  non-null

  List of errors that occured while executing the mutation.

***

## Examples

* ### metafieldNamespaceCreate reference