---
title: Merchandise - Storefront API
description: >
  A [`ProductVariant`](/docs/api/storefront/2026-01/objects/ProductVariant) that
  a buyer intends to purchase at checkout.
api_version: 2026-01
api_name: storefront
type: union
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/storefront/2026-01/unions/Merchandise'
  md: 'https://shopify.dev/docs/api/storefront/2026-01/unions/Merchandise.md'
---

# Merchandise

union

A [`ProductVariant`](https://shopify.dev/docs/api/storefront/2026-01/objects/ProductVariant) that a buyer intends to purchase at checkout.

## Fields with this union

* [Base​Cart​Line.merchandise](https://shopify.dev/docs/api/storefront/2026-01/interfaces/BaseCartLine#fields-merchandise)

  INTERFACE

  Defines the shared fields for items in a shopping cart. Implemented by [`CartLine`](https://shopify.dev/docs/api/storefront/current/objects/CartLine) for individual merchandise and [`ComponentizableCartLine`](https://shopify.dev/docs/api/storefront/current/objects/ComponentizableCartLine) for grouped merchandise like bundles.

  Each implementation includes the merchandise being purchased, quantity, cost breakdown, applied discounts, custom attributes, and any associated [`SellingPlan`](https://shopify.dev/docs/api/storefront/current/objects/SellingPlan).

* [Cart​Line.merchandise](https://shopify.dev/docs/api/storefront/2026-01/objects/CartLine#field-CartLine.fields.merchandise)

  OBJECT

  An item in a customer's [`Cart`](https://shopify.dev/docs/api/storefront/current/objects/Cart) representing a product variant they intend to purchase. Each cart line tracks the merchandise, quantity, cost breakdown, and any applied discounts.

  Cart lines can include custom attributes for additional information like gift wrapping requests, and can be associated with a [`SellingPlanAllocation`](https://shopify.dev/docs/api/storefront/current/objects/SellingPlanAllocation) for purchase options like subscriptions, pre-orders, or try-before-you-buy. The [`instructions`](https://shopify.dev/docs/api/storefront/current/objects/CartLine#field-CartLine.fields.instructions) field indicates whether the line can be removed or have its quantity updated.

* [Componentizable​Cart​Line.merchandise](https://shopify.dev/docs/api/storefront/2026-01/objects/ComponentizableCartLine#field-ComponentizableCartLine.fields.merchandise)

  OBJECT

  Represents information about the grouped merchandise in the cart.

***

```graphql
union Merchandise = ProductVariant
```