Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket


Describes pricing in Optimizely Configured Commerce.

Optimizely Configured Commerce has a number of options to control the pricing of products. There are also options for complex pricing structures, which involve pricing at different quantity breaks or pricing for different customers.

When working with pricing, it is important to consider how pricing is displayed to guest users. The Website Access Website Navigation setting controls what users have access to before signing into the website.

The following are the approaches for implementing Pricing:

  • List Pricing
  • Price Matrix
  • Real-Time Pricing

Additional features to consider when working with Pricing include:

  • Sales Pricing - This is commonly implemented with Basic Pricing
  • Quantity-Break Pricing

List pricing

List Pricing is essentially one price for all customers, often implemented in a B2C site. Configuring Basic Pricing involves setting a price directly within the Admin Console or via integration. 



Price filtering is only available when using List Pricing.

Use the following steps to configure the basic list price within the Admin Console: 

  1. Go to Admin Console > Catalog > Products.
  2. Search for the product.
  3. Click Edit on the product record.
  4. Find the Basic List Price field under the Details finger tab. During the integration of the ERP with Configured Commerce, it is common to set the Basic List Price. To modify the price, click the field and edit the existing value.
  5. Click Save.

Sales pricing

Sale prices, commonly used with the Basic PricingList Price pricing service, can be set for a product on the Product Details page of the Admin Console. The value entered into the Basic Sale Price field supersedes the price that is listed for the Basic List Price. The sale price is controlled by setting a schedule for the sale price using the Basic Sale Start Date and Basic Sale End Date fields. The sale price is then displayed on the website along with the Basic Price, which is struck out. The sale price is then displayed on the website and the basic price, along with the amount saved and percentage saved are displayed in italics. Displaying the savings amount and percentage saved is enabled by default using the Show Savings Amount and Show Savings Percent settings. These settings can be configured uniquely per website using the .

Use the following steps to set the sales price for a product.

  1. Go to Admin Console > Catalog > Products.
  2. Search for the product record you want to modify.
  3. Click Edit on the product record.
  4. In the Details tab, find the Basic Sale Price field. The value is the amount that is set to reflect the new price. To modify the price, click into the field and enter a value.
  5. Under Basic Sale Start, click Calendar and Time to select the start date and time of the sales price.
  6. Under Basic Sale End, click the Calendar and Time buttons to select the end date and time of the sales price.
  7. Click Save.

There are two ways to change the basic price of a product to a sale price:

  • Through a Basic Sale Price field
  • Through a Promotion.

The Basic Sale Price field may be used more often for instances such as clearance items or a special purchase from a vendor. Promotions allow for sales prices, but also track client's spending patterns and habits. Neither choice is mandatory and solely dependent upon the needs of the user.

Price matrix

The Price Matrix is a feature that is designed to create flexible pricing options based on customers and products. This is accomplished by employing logic that creates a hierarchical pricing structure, which can be used by many accompanying ERPs.

The Price Matrix creates a generic construct that could be used for storing complex pricing information across various ERP systems. It is intentionally non-normalized data to create a data structure that can perform the calculations with minimal latency. It does have its limitations, such as a maximum of 10 price breaks.

Each ERP or custom application of the matrix can use different data in specific fields (RecordType, CustomerKeyPart, ProductKeyPart, CalculationFlags) as needed to accommodate the pricing functions.

Price filtering is not available when using Price Matrix.

The Price Matrix uses a logical process flow to calculate pricing for products. It uses a generalized approach to pricing with adjustments depending on the ERP.

The general process flow for pricing is as follows:

  1. Gather all appropriate records from the Configured Commerce Price Matrix Table
  2. Organize potential price records into a hierarchy, from most specific to most general (also applies to warehouse, currency and unit of measure)
  3. Identify the first record within the hierarchy that matches the specific pricing scenario
  4. Calculate pricing utilizing the price record identified above
  5. Compare the calculated price to the sales price
  6. Return the lowest value between the calculated or sales price

Quantity-break pricing

Configured Commerce provides the option to display quantity-break pricing on the website. This functionality allows users to have a visual cue for qualifying quantity break prices.

Quantity based pricing is available for both Price Matrix and Real Time implementation approaches. In order for the Quantity Based Pricing table to display on the website for the Real Time implementation, quantity break points and pricing are required as a part of the Real Time call response data. For the Price Matrix implementation, the Quantity Based Pricing table will display on the website if the quantity break points and pricing are found within the Configured Commerce Price Matrix table.

  1. Go to Admin ConsoleAdministration > SystemSettings.

  2. In the search box, enter Pricing Service.

  3. Look for and select Pricing Service

  4. Selecting any of the choice other than List Price, will allow the Price Matrix



    Price Break data needs to be available in order for it to display on the website.

Items set up with Quantity-Break Pricing will display a link titled Quantity Pricing. Hovering over the link will display a box that shows the quantity pricing breaks, along with the savings percentage.

Real-time pricing

On e-commerce websites, it often is necessary to provide customers with pricing and inventory information in real time. Use real-time pricing or inventory to account for any pricing or inventory changes made in the ERP throughout the day, rather than waiting for the next refresh. The Configured Commerce integration framework can be configured to enable real-time integration jobs. So, rather than running the pricing refresh or inventory refresh job on a recurring schedule, the platform can be configured to run the integration jobs every 500 milliseconds. Configured Commerce has a real-time pricing plug-in architecture that developers can use to call any pricing service or API. Real time pricing calls are made as users goes through the website, but are cached to improve performance. Utilizing AJAX web development technique, pricing information is loaded asynchronously from the rest of the page, allowing the users to quickly navigate the website, and not have to wait for pricing information to load.



Enabling Realtime Pricing prevents price sorting on the website, regardless of the number of items shown.