---
title: Attribute - Storefront API
description: >-
  A custom key-value pair for storing additional information on

  [carts](/docs/api/storefront/2026-10/objects/Cart), [cart

  lines](/docs/api/storefront/2026-10/objects/CartLine),

  [orders](/docs/api/storefront/2026-10/objects/Order), and [order line

  items](/docs/api/storefront/2026-10/objects/OrderLineItem).

  Common uses include gift wrapping requests, customer notes, and tracking
  whether

  a customer is a first-time buyer.


  Attributes set on a cart carry over to the resulting order after checkout. Use
  the
  [`cartAttributesUpdate`](/docs/api/storefront/2026-10/mutations/cartAttributesUpdate)

  mutation to add or modify cart attributes. For a step-by-step guide, see

  [managing carts with the Storefront
  API](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/cart/manage).
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/objects/Attribute'
  md: 'https://shopify.dev/docs/api/storefront/latest/objects/Attribute.md'
api_name: storefront
api_type: graphql
type: object
---

# Attribute

object

A custom key-value pair for storing additional information on [carts](https://shopify.dev/docs/api/storefront/2026-10/objects/Cart), [cart lines](https://shopify.dev/docs/api/storefront/2026-10/objects/CartLine), [orders](https://shopify.dev/docs/api/storefront/2026-10/objects/Order), and [order line items](https://shopify.dev/docs/api/storefront/2026-10/objects/OrderLineItem). Common uses include gift wrapping requests, customer notes, and tracking whether a customer is a first-time buyer.

Attributes set on a cart carry over to the resulting order after checkout. Use the [`cartAttributesUpdate`](https://shopify.dev/docs/api/storefront/2026-10/mutations/cartAttributesUpdate) mutation to add or modify cart attributes. For a step-by-step guide, see [managing carts with the Storefront API](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/cart/manage).

## Fields

* key

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

  non-null

  The key or name of the attribute. For example, `"customersFirstOrder"`.

* value

  [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  The value of the attribute. For example, `"true"`.

***

## Map

### Fields with this object

* [BaseCartLine.attribute](https://shopify.dev/docs/api/storefront/latest/interfaces/BaseCartLine#fields-attribute)
* [BaseCartLine.attributes](https://shopify.dev/docs/api/storefront/latest/interfaces/BaseCartLine#fields-attributes)
* [Cart.attribute](https://shopify.dev/docs/api/storefront/latest/objects/Cart#field-Cart.fields.attribute)
* [Cart.attributes](https://shopify.dev/docs/api/storefront/latest/objects/Cart#field-Cart.fields.attributes)
* [CartLine.attribute](https://shopify.dev/docs/api/storefront/latest/objects/CartLine#field-CartLine.fields.attribute)
* [CartLine.attributes](https://shopify.dev/docs/api/storefront/latest/objects/CartLine#field-CartLine.fields.attributes)
* [ComponentizableCartLine.attribute](https://shopify.dev/docs/api/storefront/latest/objects/ComponentizableCartLine#field-ComponentizableCartLine.fields.attribute)
* [ComponentizableCartLine.attributes](https://shopify.dev/docs/api/storefront/latest/objects/ComponentizableCartLine#field-ComponentizableCartLine.fields.attributes)
* [Order.customAttributes](https://shopify.dev/docs/api/storefront/latest/objects/Order#field-Order.fields.customAttributes)
* [OrderLineItem.customAttributes](https://shopify.dev/docs/api/storefront/latest/objects/OrderLineItem#field-OrderLineItem.fields.customAttributes)