---
title: "Quantity Manager: Message Placeholders Reference"
description: "Reference for the placeholders in WooCommerce quantity messages: minimum, maximum, step and fixed quantities."
url: "https://wpfactory.com/docs/quantity-manager-message-placeholders-reference/"
updated: "2026-09-26"
category: References
---

# Quantity Manager: Message Placeholders Reference

## Message placeholders reference

Every notification message in the [Min Max Step Quantity Limits Manager for WooCommerce](https://wpfactory.com/item/product-quantity-for-woocommerce/) supports placeholders that are replaced with live values when the message is shown. Each message field lists the placeholders it accepts directly beneath it; this article collects them in one place.

### Minimum quantity messages

| Placeholder | Replaced with |
| --- | --- |
| `%min_cart_total_quantity%` | The required cart-total minimum. |
| `%cart_total_quantity%` | The customer's current cart total. |
| `%min_per_item_quantity%` | The per-item minimum. |
| `%item_quantity%` | The current item quantity. |
| `%product_title%` / `%category_title%` / `%attribute_title%` | The product, category or attribute name (per-scope messages). |

### Maximum quantity messages

Use `%max_cart_total_quantity%`, `%cart_total_quantity%`, `%max_per_item_quantity%`, `%item_quantity%`, and `%product_title%` / `%category_title%` / `%attribute_title%` in the matching maximum-quantity messages.

### Step quantity messages

| Placeholder | Replaced with |
| --- | --- |
| `%quantity_step%` | The step value. |
| `%quantity%` | The current quantity. |
| `%remaining_to_next%` | How many more units reach the next valid step. |
| `%next%` | The next valid step quantity. |
| `%step_cart_total_quantity%` | The cart-total step value. |

### Fixed (allowed/disallowed) quantity messages

Use `%allowed_quantity%` or `%disallowed_quantity%`, `%quantity%`, and the relevant title placeholder (`%product_title%`, `%category_title%`, `%attribute_item_title%`).

### Default quantity messages

Use `%default_per_item_quantity%`, `%item_quantity%` and `%product_title%`.

### Total price by quantity template

The Total Price by Quantity template accepts `%price%`, `%qty%`, `%unit%` and the expression form `{{%qty / %quantity_step}}`. The `%unit%` value is read from product level first, then category level, then the global label.

### Buy all stock messages

The success message accepts `%qty%` and `%product_title%`.

### Need a hand?

Our team answers every ticket on the [Quantity Manager support forum](https://wpfactory.com/support/item/product-quantity-for-woocommerce/).

Related articles

- [Quantity Manager: Developer Hooks and Filters Reference](https://wpfactory.com/docs/quantity-manager-hooks-filters-reference/)
- [Quantity Manager: How to Reset a Settings Section](https://wpfactory.com/docs/quantity-manager-reset-settings-section/)
- [Quantity Manager Shortcodes](https://wpfactory.com/docs/minmax-default-quantity/)
- [How to Install Quantity Manager: Min, Max and Step Quantities for WooCommerce](https://wpfactory.com/docs/install-min-max-quantity/)
- [How to Show Quantity Messages in Multiple Languages](https://wpfactory.com/docs/multilingual-setup-guide/)