Discounts

You've created a cart template or a customers/order template.

To display discounts in your theme, you'll use the following:

• The discount_application object
• The discount_allocation object
• The line_item object

The discount_application object registers discounts at the cart, checkout, or order level. Depending on where you're implementing your discount display, you'll access the relevant discount applications through the associated parent object:

• For the cart template:
  • cart.discount_applications
  • cart.cart_level_discount_applications
• For the customers/order template:
  • order.discount_applications
  • order.cart_level_discount_applications

The discount_allocation object associates a discount_application with a line item.

You can access an array of all of the discount allocations associated with a line item using line_item.line_level_discount_allocations.

To complete the price display, you need to use price and discount attributes of the line_item object, including:

• original_price
• original_line_price
• final_price
• final_line_price
• line_level_total_discount

Because discounts can apply to line items or to the cart or order as a whole, you should display discount information in two places:

• With individual line items
• With the total summary

The examples in this tutorial use the cart template. However, you can adapt these examples to add discounts to the customers/order template by using the order object where the cart object is used.

You can implement the components directly in a Liquid template, or in a section in a JSON template.

If a discount applies to specific line items, then it should be displayed with those items. To display discounts with line items, you need to include the following in your display:

• The line item price
• The line item discount

If a discount has been applied to a line item, then you should show the original price with a strikethrough, as well as the new discounted price. Each of these can be accessed with the following attributes of the Liquid line_item object:

• original_price
• original_line_price
• final_price
• final_line_price

If a discount has been applied to a line item, then you should show each discount that's applied, with its associated discount amount, or a total discount amount. Line item-specific discounts can be accessed through the line_level_discount_allocations attribute of the Liquid line_item object, and the total line item discount can be accessed through the line_level_total_discount attribute.

The following is an example that outputs the price and discounts display:

The subtotal is the line item total after line item discounts have applied, and the total is the cart total after cart discounts have applied. If a discount applies to the cart as a whole, then it should display between the subtotal and total.

Cart-level discounts can be accessed through the cart_level_discount_applications attribute of the cart or order object.