---
title: metafieldsSet - Shop Users API
description: Set or Update a Metafield on a resource.
api_version: unstable latest
source_url:
  html: https://shopify.dev/docs/api/shop-users/latest/mutations/metafieldsSet
  md: https://shopify.dev/docs/api/shop-users/latest/mutations/metafieldsSet.md
---

# metafields​Set

mutation

Set or Update a Metafield on a resource.

## Arguments

* metafields

  [\[Metafield​Set​Input!\]!](https://shopify.dev/docs/api/shop-users/latest/input-objects/MetafieldSetInput)

  required

***

## Metafields​Set​Payload returns

* metafields

  [\[Metafield!\]](https://shopify.dev/docs/api/shop-users/latest/objects/Metafield)

* user​Errors

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

  non-null

  List of errors that occured while executing the mutation.

***

## Examples

* ### metafieldsSet reference