ProductPricing - Liquid Object Reference

This article requires advanced skills to implement.
Liquid

Description

The ProductPricing object contains information about a Product's price.

Attributes

Attribute Type Description
checkout_price Number Returns the amount required to be paid at the checkout for this Product
deposit_amount Number Returns the deposit amount, if a deposit is required
deposit_required? Boolean Indicates whether a deposit is required
has_price? Boolean Indicates that this Product has a price and can be sold
has_sale_price? Boolean Indicates whether this Product has a sale price
hide_price_text String Returns the text to display instead of the price when the price should be hidden
hide_price? Boolean Indicates whether this Product's price should be hidden
on_sale? Boolean Indicates whether the Product is purchaseable and on sale at a discounted price
original_price Number Returns the original (non-sale) price for this Product
price Number Returns the current price for this Product
price_excl_tax Number Returns the current price for this Product, exclusive of tax. Only returns a value if the price is tax exclusive
price_range List Returns a list of prices from lowest to highest for this Product's variants
product Product Returns the Product that this pricing is for
sale_price Number Returns the current sale price of this Product
sale_price_excl_tax Number Returns the current sale price of this Product, exclusive of tax. Only returns a value if the price is tax exclusive
tax_inclusive? Boolean Indicates whether the price for this Product is tax inclusive
variable_pricing_max_amount Number Returns the maximum variable pricing amount for this Product
variable_pricing_min_amount Number Returns the minimum variable pricing amount for this Product

Points

Attribute Type Description
bonus_earn_points Number Returns the number of bonus points that can be earned by purchasing this Product
can_earn_points? Boolean Returns true if the Product is configured to earn points
can_purchase_with_currency? Boolean Returns true if the Product can be purchased with currency
can_purchase_with_points? Boolean Returns true if the Product can be purchased with points
checkout_earn_points Number Returns the number of points that can be earned at checkout for this Product
checkout_points Number Returns the number of points required to be paid at the checkout for this Product
deposit_points Number Returns the deposit points amount, if a points deposit is required
earn_points Number Returns the number of points that can be earned by purchasing this Product
has_sale_points? Boolean Indicates whether this Product has a sale points price
original_points Number Returns the original (non-sale) points price for this Product
points Number Returns the current points price for this Product
points_bonus? Boolean Returns true if there are any bonus_earn_points
points_sale? Boolean Returns true if there is a sale_purchase_points amount which is less than the purchase_points amount, ie the points price is on sale.
purchase_points Number Returns the number of points required to purchase this Product
sale_purchase_points Number Returns the number of points required to purchase this Product when its points price is on sale
total_earn_points Number Returns the total number of points that can be earned by purchasing this Product, ie: earn_points + bonus_earn_points
use_currency? Boolean Returns true if the cart item it has been configured to use currency for payment
use_points? Boolean Returns true if the cart item it has been configured to use points for payment

Subscriptions

Attribute Type Description
fixed_term_subscription? Boolean Returns true if the Product price is a fixed term subscription price
subscription_term Number Returns the number of subscription_term_units that make up a single subscription period.\n\nFor example, if subscription_term is 6 and subscription_term_unit is month, then one subscription period is for 6 months.
subscription_term_count Number For fixed-term subscriptions, returns the number of full terms that the subscription will have.\n\nFor example, if the subscription term is 3 months, and subscription_term_count is 4, then the total length of the subscription is 12 months, but payments are made every 3 months.
subscription_term_unit String Returns the unit of measure that applies to the subscription_term. Eg, month, or week
subscription_total_points Number For fixed-term subscriptions, this is the total points price that will be paid over the length of the subscription
subscription_total_price Number For fixed-term subscriptions, this is the total price that will be paid over the length of the subscription
subscription? Boolean Returns true if the Product price is a subscription price

Variable Pricing

Attribute Type Description
variable_pricing_amounts List Returns a list of prices that can be selected
variable_pricing_custom_allowed? Boolean Indicates whether custom amounts are allowed
variable_pricing? Boolean Indicates whether this Product uses variable pricing
Last updated July 21, 2025