Line properties and order data
What Luxe adds to cart lines and, if the merchant turns it on, to orders.
Cart line properties
Underscore keys are hidden by themes. Luxe's Functions never trust a property for price: they re-validate every set.
| Key | On | Meaning |
|---|---|---|
_luxe_kit | Build-your-own and fixed set lines | The set's id |
_luxe_slots | Build-your-own set lines | The shopper's picks, by group, versioned; missing means the default picks |
_luxe_kit_group | Every line of a collection set | Set id and a per-build token |
_luxe_gift | Gift lines | The rung that earned it |
_luxe_addon | Checkout offer and upsell lines | The offer or upsell |
_luxe_src | Any Luxe line | Where it was added, for analytics only |
On each component checkout expands: _luxe_kit, _luxe_slot (group and position, or fixed) and _luxe_pick=default for default picks. With analytics consent the cart carries a _luxe_touch attribute with surface codes and timestamps; it is never used for billing.
Includes. With "Show picks in the theme cart" on (the default), build-your-own and fixed set lines also carry one visible property, named by the Picks label ("Includes" in English), listing the picks and then the fixed components, for theme carts. Collection set lines do not have it. Display only.
Order data for ERPs and 3PLs
Optional and off by default: Settings > Data and integrations > Order data writes the luxe.kit_summary order metafield (merchant namespace, readable by other apps) once at payment, on paid orders with a Luxe set or gift, and can add an order tag (default luxe-kit). Both need the optional write_orders scope.
{
"schemaVersion": 1,
"order": "#1042",
"currency": "USD",
"kits": [
{
"kitId": "ck_sampler",
"type": "slot_kit",
"title": "Coffee sampler",
"quantity": 1,
"variantId": "gid://shopify/ProductVariant/100",
"sku": "KIT-COFFEE-6",
"expanded": true,
"total": "12.00",
"lines": [
{
"lineItemId": "gid://shopify/LineItem/9001",
"variantId": "gid://shopify/ProductVariant/301",
"sku": "COF-ETH-250",
"title": "Ethiopia Guji",
"quantity": 1,
"unitPrice": "12.00",
"discount": "0.00",
"total": "12.00",
"role": "pick"
}
]
}
],
"gifts": []
}| Field | Meaning |
|---|---|
type | slot_kit, fixed_bundle, collection_kit, or kit if a build-your-own or fixed set was deleted since |
expanded | False when the set product itself is the line |
role | pick or fixed; absent on collection set lines |
rungId | On gift lines: the rung that earned the gift |
| Amounts | Decimal strings in the shop currency; a set's total is the sum of its lines |