This reference lists the placeholders you can use in the templates and shortcodes of Price by Quantity & Bulk Quantity Discounts for WooCommerce. Placeholders are wrapped in percent signs, for example %new_price_total%, and are replaced at render time.
Price and discount placeholders #
These are used in the Price Display by Qty templates and the Qty Dropdown label template.
| Placeholder | Meaning |
|---|---|
%qty% |
The selected quantity. |
%qty_total% |
Total quantity (dropdown label template only). |
%old_price_single% |
Original per-unit price. |
%new_price_single% |
Discounted per-unit price. |
%old_price_total% |
Original price times quantity. |
%new_price_total% |
Discounted price times quantity. |
%discount_value% |
Discount amount as configured for the level. |
%discount_percent% |
Discount as a percentage. Add a second % for a literal percent sign. |
%discount_single% |
Amount saved per unit. |
%discount_total% |
Amount saved across the quantity. |
Each of the four price placeholders also has tax-specific variants, formed by adding _incl_tax or _excl_tax before the closing percent sign: %old_price_single_incl_tax%, %old_price_single_excl_tax%, %new_price_single_incl_tax%, %new_price_single_excl_tax%, %old_price_total_incl_tax%, %old_price_total_excl_tax%, %new_price_total_incl_tax%, and %new_price_total_excl_tax%.
Deprecated: older templates used %old_price% and %price%. They still work but map to %old_price_single% and %new_price_single%. Use the newer names in new templates.
Product table placeholders #
These are used in the [alg_wc_product_wholesale_pricing_table] shortcode, in attributes such as heading_format, percent_row_format and discount_row_format.
| Placeholder | Meaning |
|---|---|
%level_min_qty% |
Minimum quantity for the level. |
%level_max_qty% |
Maximum quantity before the next level. |
%level_discount% |
The level’s configured discount value. |
%level_discount_amount% |
Saved amount as a number. |
%level_discount_amount_price% |
Saved amount formatted as a price. |
%level_discount_percent% |
Saved percentage (2 decimals). |
%level_discount_percent_rounded% |
Saved percentage rounded to a whole number. |
The price row (price_row_format and total_min_qty_price_row_format) additionally accepts the %old_price_single%, %new_price_single%, %old_price_total% and %new_price_total% placeholders and their tax variants.
Products list placeholders #
In the Pro [alg_wc_ppq_products_list] shortcode, level column headings accept %level_min_qty%, %level_discount% and %level_num% (the level’s position, starting at 1).
Related #
Price by Quantity
Get more from Price by Quantity
See every feature and the pricing on the Price by Quantity plugin page.
See Price by Quantity shortcodes, the products list shortcode, real-time price display, and the quantity dropdown.
Need a hand? #
Our team answers every ticket on the Price by Quantity support forum.