---
title: CartMetafieldsSetPayload - Storefront API
description: Return type for `cartMetafieldsSet` mutation.
api_version: 2025-01
api_name: storefront
type: payload
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/2025-01/payloads/CartMetafieldsSetPayload
  md: >-
    https://shopify.dev/docs/api/storefront/2025-01/payloads/CartMetafieldsSetPayload.md
---

# Cart​Metafields​Set​Payload

payload

Return type for `cartMetafieldsSet` mutation.

## Fields

* metafields

  [\[Metafield!\]](https://shopify.dev/docs/api/storefront/2025-01/objects/Metafield)

  The list of cart metafields that were set.

* user​Errors

  [\[Metafields​Set​User​Error!\]!](https://shopify.dev/docs/api/storefront/2025-01/objects/MetafieldsSetUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Mutations with this payload

* [cart​Metafields​Set](https://shopify.dev/docs/api/storefront/2025-01/mutations/cartMetafieldsSet)

  mutation

  Sets cart metafield values. Cart metafield values will be set regardless if they were previously created or not.

  Allows a maximum of 25 cart metafields to be set at a time.

  * metafields

    [\[Cart​Metafields​Set​Input!\]!](https://shopify.dev/docs/api/storefront/2025-01/input-objects/CartMetafieldsSetInput)

    required

    ### Arguments

    The list of Cart metafield values to set. Maximum of 25.

    The input must not contain more than `250` values.

  ***

***

## Map

### Mutations with this payload

* [cart​Metafields​Set](https://shopify.dev/docs/api/storefront/2025-01/types/cartMetafieldsSet)