Display Paths
Display paths are the values you can pass to data-next-display. They are grouped into namespaces — cart.*, package.*, campaign.*, order.*, profile.*, selection.* — each backed by a different store.
Cart
Live values from the cart.
| Path | Description | Example output |
|---|---|---|
cart.total | Grand total | $99.99 |
cart.subtotal | Subtotal before shipping/tax | $89.99 |
cart.shipping | Shipping cost | $10.00 |
cart.tax | Tax amount | $8.00 |
cart.discount | Discount amount | $10.00 |
cart.totalQuantity | Total units in cart | 5 |
cart.itemCount | Distinct line items | 3 |
cart.currency | Active currency code | USD |
cart.isEmpty | Empty state boolean | true / false |
<span data-next-display="cart.total">$0.00</span>
<span data-next-display="cart.totalQuantity">0</span>For a complete cart-aware UI, use Cart Summary — it documents every cart attribute alongside templates and reference tables.
Package
Live values for a specific package. Use package.[id].<property> where [id] is the package's ref_id.
| Path | Description |
|---|---|
package.[id].name | Package display name |
package.[id].image | Image URL |
package.[id].price | Per-unit price |
package.[id].price_total | Total package price |
package.[id].price_retail | Retail (compare-at) per-unit price |
package.[id].savingsAmount | Total savings |
package.[id].savingsPercentage | Savings as percentage |
package.[id].hasSavings | Boolean — has savings |
package.[id].isBundle | Boolean — is multi-pack |
package.[id].qty | Units in the package (for bundles) |
package.[id].interval | Subscription interval (month, day) |
package.[id].interval_count | Number of intervals per cycle |
package.[id].is_recurring | Boolean — is subscription |
For shorthand syntax inside a parent with data-next-package-id, see Package Display.
For the full property list (including discount-context properties that require an active cart), see Reference → Attributes.
Campaign
Campaign-level data loaded once on init.
| Path | Description |
|---|---|
campaign.name | Campaign name |
campaign.currency | Active currency code |
campaign.language | Active language code |
See Campaign Attributes for the dedicated reference.
Order
Live order data on post-purchase pages where ?ref_id= has loaded an order.
| Path | Description |
|---|---|
order.total | Grand total |
order.subtotal | Subtotal |
order.shipping | Shipping cost |
order.tax | Tax amount |
order.refId | Order reference ID |
order.number | Human-readable order number |
order.customer.name | Customer full name |
order.shippingAddress.full | Pre-formatted address |
See Order Data for every order property.
Profile
Currently active customer profile.
| Path | Description |
|---|---|
profile.active | Active profile ID |
profile.exists | Boolean — a profile is active |
For conditional display by profile, use the dedicated data-next-show-if-profile / data-next-hide-if-profile attributes — see State → Reference → Attributes.
Selection
Currently selected card in a data-next-cart-selector container with a data-next-selector-id.
| Path | Description |
|---|---|
selection.<id>.name | Selected package name |
selection.<id>.price | Per-unit price |
selection.<id>.total | Total price (price × quantity) |
selection.<id>.savingsAmount | Calculated savings |
selection.<id>.hasSelection | Boolean — at least one card is selected |
See Selection for every property.
Raw Numeric Values
Append .raw to a numeric path to get the underlying number rather than a formatted string. Required when the value is the input to a math operator.
<!-- 10% of total -->
<span data-next-display="cart.total.raw"
data-multiply-by="0.1"
data-format="currency">$9.90</span>Available on most numeric paths: cart.total.raw, package.[id].price.raw, order.total.raw, selection.<id>.total.raw, etc.
Combining Paths and Math
Display paths can be the input to inline math operators like data-multiply-by, data-divide-by, data-add, data-subtract. See Configuration → Math.
<!-- Discount as % of subtotal -->
<span data-next-display="cart.discount"
data-divide-by="cart.subtotal"
data-multiply-by="100"
data-format="percentage">10%</span>Next Steps
- Render cart line items with templates: Cart Items Template
- Package-scoped shorthand syntax: Package Display
- Full attribute and modifier reference: Reference → Attributes