cartMetafieldsSet

Sets Metafield values on a cart, creating new metafields or updating existing ones. Accepts up to 25 metafields per request.

Use it in a workflow

Query

This is the mutation the action sends by default. Edit it in the step's Query field to change which fields come back.

mutation CartMetafieldsSet($metafields: [CartMetafieldsSetInput!]!) {
  cartMetafieldsSet(metafields: $metafields) {
    metafields {
      createdAt
      description
      id
      key
      list
      namespace
      parentResource
      reference
      type
      updatedAt
      value
    }
    userErrors {
      code
      elementIndex
      field
      message
    }
  }
}

Variables

Pass these as a JSON object in the step's Variables field.

{
  "metafields": [
    {
      "ownerId": "string",
      "key": "string",
      "value": "string",
      "type": "string"
    }
  ]
}

Response

Read the result with {{cartmetafieldsset.response.data.data.cartMetafieldsSet}}. If the API returns errors, the step fails and they are at {{cartmetafieldsset.response.data.errors}}.

Need more? See the Shopify Storefront guide for connection setup and behaviour shared by every action.