Getting Started
About Stencil
Transitioning to Stencil
Installing Stencil
Authentication & Tokens
Running Stencil Locally
Advanced Installation Options
Template Files
Templates Directory
Custom Templates
Customize Stencil Checkout
Handlebars and Stencil
Handlebars.js Overview
Handlebars Helpers
Stencil Object Model
REFerence
Stencil Objects

Cart Price Properties

This page shows the price properties available on the {{cart.items}} object.

For the examples below we will use a cart_item with the following pricing:

  • Base Price: $100
  • MSRP: $99
  • Sale Price: $55
  • Bulk Pricing: Set as a percentage.
    • Buy two items get 1%
    • Buy three items get 2%
    • Buy four items get 3%

RRP

rrp is the MSRP or Manufactures Suggested Retail Price. This number will always be the same unless it is changed at the product level.

rrp
    "rrp": {
      "formatted": "$99.00",
      "value": 99
    },

Bulk Pricing

bulk_pricing shows the lowest calculated price.

Item on sale with 2 items added to the cart:

Item not on sale with 2 items added to the cart
    "bulk_pricing": {
      "base_price": {
        "formatted": "$99.00",
        "value": 99
      },
Item on sale with 2 items added to the cart
    "bulk_pricing": {
      "base_price": {
        "formatted": "$54.45",
        "value": 54.45
      },

Price

price shows the lowest calculated price of a single cart item.

Two items in cart not on sale
    "price": {
      "formatted": "$100.00",
      "value": 100
    },
Two items in cart on sale
    "price": {
      "formatted": "$55.00",
      "value": 55
    },
Two items in cart on sale with bulk pricing
    "price": {
      "formatted": "$54.45",
      "value": 54.45
    },

Cart Item Object Example

Cart Item Response
[
  {
    "availability": "",
    "brand": {
      "name": ""
    },
    "bulk_pricing": {
      "base_price": {
        "formatted": "$54.45",
        "value": 54.45
      },
      "discount_amount": null,
      "discount_percentage": null
    },
    "can_modify": true,
    "configurable_fields": [],
    "custom_fields": [],
    "id": "0c78e8f6-bc12-4a97-ba43-d1ebbdff1d71",
    "image": null,
    "max_purchase_quantity": null,
    "min_purchase_quantity": "0",
    "name": "BigCommerce Water Bottle",
    "options": [],
    "price": {
      "formatted": "$54.45",
      "value": 54.45
    },
    "product_id": 202,
    "quantity": 2,
    "release_date": "",
    "remove_url": "/cart.php?action=remove&item=0c78e8f6-bc12-4a97-ba43-d1ebbdff1d71",
    "rrp": {
      "formatted": "$99.00",
      "value": 99
    },
    "show_gift_wrapping": true,
    "sku": "",
    "total": {
      "formatted": "$108.90",
      "value": 108.9
    },
    "type": "Item",
    "url": "https://{store_hash}/bigcommerce-water-bottle/"
  }
]