Volume Prices overview

Edit on GitHub

In highly competitive markets, the business tactic is made compelling by issuing drastic discounts when buying products in large quantities or volumes.

Volume pricing helps the merchants to gain the commitment of the customers. Providing volume discounts result in increasing the placement of large orders with the small ones. Large orders are preferred as they reduce the expenses incurred by the company.

Such incentives allow a business company to purchase additional inventory at a reduced cost and allow sellers or manufacturers to reduce the products by selling more units and increase their revenues per transaction.

The schema below illustrates the connection between spy_price_product_store table links spy_price_product_merchant_relationship with the spy_currency and spy_store tables.

Database schema

price_data inspy_price_product_store table contains a JSON with prices per mode, currency and type.

The “price_data” field is a JSON with attributes such as volume prices, merchant prices, customer prices and then a specific set of prices inside its price type ([“QTY” => 10, “GROSS(DEFAULT)” => 100, “NET(DEFAULT)” => 90]).

You can find the example of the JSON below:

	"EUR" => [
		"GROSS_MODE" => [
		"DEFAULT" => 9999,
		"ORIGINAL" => 12564,
		"NET_MODE" => [
		"DEFAULT" => 8999,
		"ORIGINAL" => 11308,

		"price_data" => ["QTY" => 10, "GROSS(DEFAULT)" => 100, "NET(DEFAULT)" => 90], ["QTY" => 20, "GROSS(DEFAULT)" => 90, "NET(DEFAULT)" => 80]
		"CHF" => [
		"GROSS_MODE" => [
		"DEFAULT" => 11499,
		"ORIGINAL" => 14449,
		"NET_MODE" => [
		"DEFAULT" => 10349,
		"ORIGINAL" => 13004,

Volume prices are configured per store and per currency and a Store Administrator can set volume prices for every locale.

Volume prices are set for both gross and net mode and are either inherited from the abstract product or specified directly for a standalone concrete product.

The concrete product can also have its own volume prices different from its abstract (if they are explicitly defined per `concrete_sku`).

A specific volume price for a concrete product has a higher priority over an inherited one from its abstract product.

The volume prices are imported using data importer. The JSON with volume prices is added to the price_data.volume_prices column as shown in the example:

CSV file containing volume prices

After the import is completed the volume prices are shown on the product detail page:

Volume prices displayed on the product detail page

Once the product is added to the shopping list or to the cart, the item price corresponding to the volume price is displayed for that quantity. If the user increases or decreases the quantity in cart (but not in shopping list since here we don’t really change quantities), the price is updated once the user goes over or under a threshold defined by the volume prices.


Volume pricing is applied when a certain threshold is reached.

Threshold is a minimum value that serves as a benchmark/boundary for a discounted price when the product is dependent on the volume (e.g. the number of units of the product) bought.

This means that if you buy more quantity of products or sometimes may be group of products, you would get discount based on the volume of purchase. All of the individual products exceeding the threshold will receive the special price.

The volume price is applicable only if the shopper exceeds a certain quantity threshold - the number of units the customer chooses to buy.

The following table illustrates a typical volume pricing model:

Quantity of products Price per products Total Price
1 $100 $100
5 $70 $350
10 $50 $500
20 $40 $800

The new price will go into effect after 5 units are purchased and only apply to the units beyond that threshold. The buyer would still pay full price for the first 5 units they procured.

If the customer selects five, each unit will cost $70. If the customer selects 12, each unit will cost $50.

Volume prices can also mean higher prices per item at increasing thresholds.

That is a particular case of electricity bills where you pay more if you use more.

Current Constraints

Currently, the feature has the following functional constraints which are going to be resolved in the future.
  • unlike other prices in Spryker which support both price types (DEFAULT and ORIGINAL), volume price supports only DEFAULT price type

  • as volume price does not support ORIGINAL price type, you cannot define a promotion for a volume price

  • volume prices cannot be applied to the prices per merchant relation.

Add volume prices to abstract products
Developer guides

Are you a developer? See Prices feature walkthrough for developers.