Deprecated objects and object properties
The following Liquid objects and object properties are considered deprecated. Many of them have been replaced, so it's recommended that you use the alternative, if one is listed.
The following properties of the checkout
object are deprecated:
checkout.unavailable_line_items
Anchor link to section titled "checkout.unavailable_line_items"Returns the unavailable line items of the checkout. Deprecated because it's always empty.
checkout.fulfilled_line_items
Anchor link to section titled "checkout.fulfilled_line_items"Returns the fulfilled line items of the checkout. Deprecated because it's always empty.
checkout.unfulfilled_line_items
Anchor link to section titled "checkout.unfulfilled_line_items"Returns the unfulfilled line items of the checkout. Deprecated because it's always equal to line_items
.
checkout.fulfillment_status
Anchor link to section titled "checkout.fulfillment_status"Returns the fulfillment status of the checkout. Deprecated because it always returns 'unfulfilled'.
checkout.financial_status
Anchor link to section titled "checkout.financial_status"Returns the financial status of the checkout. Deprecated because it always returns nil.
checkout.fulfilled_at
Anchor link to section titled "checkout.fulfilled_at"Returns the date of fulfillment of the checkout. Deprecated because it always returns nil.
checkout.discount
Anchor link to section titled "checkout.discount"Returns the discount applied to the checkout but not saved. Deprecated because on the order status page, an unsaved discount cannot exist.
checkout.discounts
Anchor link to section titled "checkout.discounts"Returns the discounts applied to the checkout. The amounts are in the customer's local (presentment) currency.
Deprecated because it does not include all discount types and all discount details.
checkout.cancelled
Anchor link to section titled "checkout.cancelled"Returns whether the checkout is cancelled. Deprecated because it always returns false.
The discount
object contains information about a discount, including its id
, code
, amount
, savings
, and type
. Deprecated because it does not include all discount types and all discount details.
The following properties of the discount
object are also deprecated:
discount.amount
Anchor link to section titled "discount.amount"Returns the amount of the discount.
discount.code
Anchor link to section titled "discount.code"Returns the title or discount code of the discount.
discount.id
Anchor link to section titled "discount.id"Returns the id of the discount.
discount.savings
Anchor link to section titled "discount.savings"Returns the amount of the discount's savings. The negative opposite of discount.amount
.
discount.title
Anchor link to section titled "discount.title"Returns the title or discount code of the discount.
discount.total_amount
Anchor link to section titled "discount.total_amount"Returns the total amount of the discount if it has been applied to multiple line items.
discount.total_savings
Anchor link to section titled "discount.total_savings"Returns the total amount of the discount's savings if it has been applied to multiple line items. The negative opposite of total_amount.
discount.type
Anchor link to section titled "discount.type"Returns the type of the discount. The possible values of discount.type
are:
- FixedAmountDiscount
- PercentageDiscount
- ShippingDiscount
The following properties of the line_item
object are deprecated:
line_item.discounts
Anchor link to section titled "line_item.discounts"Returns any discounts that scripts have applied to the line item. This attribute only has a value if you're using the Script Editor app.
Deprecated because it does not include all discount types and all discount details.
line_item.line_price
Anchor link to section titled "line_item.line_price"Returns the combined price of all the items in the line item. This includes any discounts from Shopify Scripts that were applied on the line. This is equal to line_item.price
multiplied by line_item.quantity
.
Deprecated because it does not include code discounts.
line_item.price
Anchor link to section titled "line_item.price"Returns the price of the line item including any discounts from Shopify Scripts that were applied on the line.
Deprecated because it does not include code discounts.
line_item.total_discount
Anchor link to section titled "line_item.total_discount"Returns the total amount of all discounts applied to the line item.
This attribute only has a value if you are using the Script Editor app.
Deprecated because it does not include all possible discounts.
The following properties of the order
object are deprecated:
order.discounts
Anchor link to section titled "order.discounts"Returns an array of discounts for an order.
Deprecated because it does not contain all discount types and all discount details.
The following properties of the shop
object are deprecated:
shop.enabled_locales
Anchor link to section titled "shop.enabled_locales"Returns an array of shop_locale
objects. Each object represents a shop locale that's published on the shop.
Deprecated because it was not clear that this value returned published locales.
shop.locale
Anchor link to section titled "shop.locale"Returns the language locale that the store is currently displayed in. For example, en
, fr
, or pt-BR
.
Deprecated because this value is contextual to the request and not a property of the shop resource.
shop.taxes_included
Anchor link to section titled "shop.taxes_included"Returns true
if taxes are included in your products' prices. Otherwise, returns false
.
Deprecated because whether or not prices have taxes included can vary based on the customer's country. Because this attribute varies based on the customer's context, it makes more sense as an attribute of the cart
object.
The theme
object contains information about the current theme. Deprecated because the values of this object's properties are subject to change, and therefore can't be relied on within the theme.
The following properties of the theme
object are also deprecated:
Returns the theme's ID.
Returns the theme's name.
Returns the theme's role. The following are the possible values for theme.role
:
- main: The theme is published. Customers see it when they visit the online store.
- unpublished: The theme is unpublished. Customers can't see it.
- demo: The theme is installed on the store as a demo. The theme can't be published until the merchant buys the full version.
- development: The theme is used for development. The theme can't be published, and is temporary.