Commerce Commerce 1.x Products Price Types

Price Types allow you to define prices in different currencies while covering different use cases, including temporary sale and bulk discount pricing.

This document explains these concepts and implementation for developers and agencies who are implementing Commerce.

On this page:

Table of Contents

(Retail) Prices & Price Types

In Commerce each product has a standard/retail price for each enabled currency. This is the primary price that you set when managing products, and is available with all different types of managing your product catalog. Historically this was the only price you could set for a product.

Price Types, first introduced in v1.0, give you a lot more power and flexibility. Price Types are only available for the Product List TV and Product Matrix TV, or for products managed manually from the dashboard. This indeed means that Resource Products do not support price types at the moment.

Custom product types can support price types, but that depends on their implementation. As a rule of thumb, if editing the product information looks like a normal product in the dashboard, it likely supports price types automatically, too. If it’s managed in a different component, additional development effort is needed to support price types. (If you’re a developer, you can learn more about how to integrate price types in a custom product in the developer documentation.)

Supported Price Types

Commerce ships with the following price types out of the box:

  • Sale: a single price that is only used between two date/times.
  • Sale Percentage: a percentage discount price that is only used between two date/times. The percentage price is useful for in a Matrix, as it will cascade from the matrix/row/column to each individual product.
  • Quantity: lets you set multiple prices where the returned price is based on the quantity on the order item.
  • User: lets you enter usernames and set the price for each. (Added in v1.1)
  • UserGroup: lets you select usergroups and set the price for each. (Added in v1.1)

They are not shown right away; you first need to enable their respective modules at Configuration > Modules.

Other price types that are available as extensions include:

  • Quantity Usergroup, providing a Quantity price type for specific usergroups.
  • Total Quantity, which lets you give a discount to products when a certain quantity is in the cart.
  • Simple Price Type, an example project for developers of how to start building a custom price type as a module.

Template integration

The [[+price]] and [[+price_formatted]] placeholders (and twig equivalent) contain the current best price for a product in the current currency.

To render a “From/until”-style date, you can use the [[+price_rendered]] placeholder which uses the frontend/price.twig twig template.

For date-based price types, like the Sale/Percentage Sale, which also have an expiration date set, you can also use the [[+price_valid_until]] placeholder. That contains a unix timestamp which can be rendered to a human-readable timestamp with the date output filter.

Some price types, such as the quantity price type, may define a price type label. In the example of the quantity price type that is used to indicate if the quantity is shipped as a box, pallet, etc. This label is available in the cart as item.price_label, so [[+item.price_label]] or {{ item.price_label }} depending on context. (Added in v1.4)

To render a quantity-based pricing table, use the commerce.render_quantity_price snippet.

To render prices taking into account taxes, discounts, and user/usergroup price types, use the commerce.render_taxed_price snippet.