---
title: CartLineInput - Storefront API
description: The input fields to create a merchandise line on a cart.
api_version: 2025-01
api_name: storefront
type: input-object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/storefront/2025-01/input-objects/CartLineInput'
  md: >-
    https://shopify.dev/docs/api/storefront/2025-01/input-objects/CartLineInput.md
---

# Cart​Line​Input

input\_object

The input fields to create a merchandise line on a cart.

## Fields

* attributes

  [\[Attribute​Input!\]](https://shopify.dev/docs/api/storefront/2025-01/input-objects/AttributeInput)

  An array of key-value pairs that contains additional information about the merchandise line.

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

* merchandise​Id

  [ID!](https://shopify.dev/docs/api/storefront/2025-01/scalars/ID)

  non-null

  The ID of the merchandise that the buyer intends to purchase.

* quantity

  [Int](https://shopify.dev/docs/api/storefront/2025-01/scalars/Int)

  Default:1

  The quantity of the merchandise.

* selling​Plan​Id

  [ID](https://shopify.dev/docs/api/storefront/2025-01/scalars/ID)

  The ID of the selling plan that the merchandise is being purchased with.

***

## Input objects using this input

* [Cart​Input.lines](https://shopify.dev/docs/api/storefront/2025-01/input-objects/CartInput#fields-lines)

  INPUT OBJECT

  The input fields to create a cart.

***

## Map

### Input objects using this input

* [Cart​Input.lines](https://shopify.dev/docs/api/storefront/2025-01/input-objects/CartInput#fields-lines)