Entities

Product List Item

A product membership and list-specific annotation in a saved product list

A ProductListItem is one entry in a ProductList. It stores only list-specific data; current product details and pricing resolve through its product-variant link instead of being copied into the list.

Available since v0.26.0 in @laioutr-core/canonical-types

Components

Base

ProductListItemBase

base
Optional quantity, note, position, creation time, and custom fields for the entry.
quantity
number

Desired quantity of the product.

note
string

Free-text note the customer attached to this entry.

position
number

Sort position within the list.

addedAt
Date

When the product was added to the list.

customFields
Record<string, unknown>

Custom fields are a way for implementations to pass arbitrary data to actions, queries, etc.

  • ProductListItemProductVariantProductVariant single — Resolves the entry's live purchasable variant.
Copyright © 2026 Laioutr GmbH