---
title: CheckoutLineInput Input Type
seo:
  title: CheckoutLineInput Input Type
  description: CheckoutLineInput Input Type - no description
slug: api-reference/checkout/inputs/checkout-line-input
sidebar:
  label: CheckoutLineInput
search:
  tags:
    - API reference
    - Checkout
lastModified: '2026-08-10'
---

```graphql
input CheckoutLineInput {
  quantity: Int!
  variantId: ID!
  price: PositiveDecimal
  priceOverrideReason: String
  forceNewLine: Boolean = false
  metadata: [MetadataInput!]
}
```


## Fields

### quantity [#quantity]

**`quantity`** · [`Int!`](/api-reference/miscellaneous/scalars/int)

The number of items purchased.
### variantId [#variant-id]

**`variantId`** · [`ID!`](/api-reference/miscellaneous/scalars/id)

ID of the product variant.
### price [#price]

**`price`** · [`PositiveDecimal`](/api-reference/miscellaneous/scalars/positive-decimal)

Custom price of the item. Can be set only by apps with `HANDLE_CHECKOUTS` permission. When the line with the same variant will be provided multiple times, the last price will be used.
### priceOverrideReason [#price-override-reason]

**`priceOverrideReason`** · [`String`](/api-reference/miscellaneous/scalars/string)

Reason explaining why a custom `price` was set on the line, for debugging and auditing. Can be set only by apps with `HANDLE_CHECKOUTS` permission and only when the line has a `price` override. Setting a new `price` without a reason clears the previous reason. Blank values are stored as no reason. Limited to 255 characters; longer values are truncated.

Added in Saleor 3.23

### forceNewLine [#force-new-line]

**`forceNewLine`** · [`Boolean`](/api-reference/miscellaneous/scalars/boolean)

Flag that allow force splitting the same variant into multiple lines by skipping the matching logic.

Default: `false`.
### metadata [#metadata]

**`metadata`** · [`[MetadataInput!]`](/api-reference/miscellaneous/inputs/metadata-input)

Fields required to update the object's metadata. Can be read by any API client authorized to read the object it's attached to.

Warning: never store sensitive information, including financial data such as credit card details.

## Used by

- [CheckoutCreateInput (inputs)](/api-reference/checkout/inputs/checkout-create-input)
- [checkoutLinesAdd (mutations)](/api-reference/checkout/mutations/checkout-lines-add)

---

Schema: **Saleor 3.23.43**. [Download SDL](/schema/saleor.graphql).
