scheduledPrices. A single entry is referred to as a promotional price on this page.
This guide describes how to display a running promotional price in the shop. Where the prices are maintained is covered at the end in the section Where promotional prices are maintained.
What is available in the template
These fields belong to the product object. They are therefore available everywhere a product is displayed, for example in category lists, search results, watchlists, and cart items.
Every other price field of the shop can also contain its own promotional prices. For these fields, the
getFullPriceInfo() function returns the same three values. For set products, the values setPrice, setRawPrice, setOrgPrice, setDiscount, and setDiscountPrice are added.
Outputting the price with a strike-through price and promotion text
rawPrice is always set, even when no promotion is running. Without the corresponding check in the template, the same price would be shown twice on every product, one of them struck through.
While a promotion is running, the standard price is shown as a strike-through price, the savings in percent, and the promotional price. If no promotion is running, only the standard price is shown. The promotion text has its own condition because not every promotion has a maintained promotion text.
Where promotional prices are maintained
Promotional prices are maintained in the Admin Interface on the product’s detail page in the “Scheduled prices” tab, with a separate table per price field. An entry consists of the price, the period, and an optional promotion text. Multiple entries can be stacked one after another, and the shop switches between them automatically. Maintenance via the API is described in the section Time-controlled prices (promotional prices) of the API reference.Terms and technical names
Further reading
- $wsProducts describes the price fields on the product object and
getFullPriceInfo(). - $wsBasket describes the fixed price of a cart item.
- API reference Products describes the format of the price fields and validation.
- content - Catalog describes the
pricedata type and how to create additional price fields.