Documentation

Prices

Elevate, May 20-22-2025, Miami Beach, Florida

Store and manage Prices for your Products on the Merchant Center.

Composable Commerce offers Embedded Prices and Standalone Prices that let you define full-sale prices for your sellable goods. Standalone Prices offer more flexibility for your business needs by allowing up to 50 000 Standalone Prices for each Product Variant, while only 100 Embedded Prices can be created for each Product Variant.

A Product can have both types of Prices at the same time. However, for better performance, we recommend having only one type of Price for a Product.

The Merchant Center lets you manage pricing using Embedded Prices that are embedded into the Product Variant, or Standalone Prices that are independent of the Product. As both Embedded Prices and Standalone Prices can exist for a Product, the Merchant Center also allows you to choose the Product Price used during checkout. Depending on your need, pricing can be defined for volume-based orders or to be specific to a currency, country, distribution channel, customer group, or time period. If the default fields available for Price configuration do not fit your business needs, Composable Commerce lets you extend the Price model by use of the Custom Fields API. The Merchant Center provides support for editing the values of such Custom Fields on Price.
To manage discounts for your sellable goods, see Product Discounts.
Learn more about managing Prices in our self-paced Pricing setup module.

Embedded Price

Add a Price

  1. Go to Products > Product list and select the Product that contains the Product Variant you want to create the Price for.
  2. In the Variants tab, select the Product Variant.
  3. In the Prices tab, click Add embedded price.
    Image highlighting the UI element to add a price for a Product Variant.
  4. In the Add embedded price window, follow these steps:
    1. In the Price information section, follow these steps:
      • Optional: For Price key, enter a unique identifier that helps identify the Embedded Price.
      • For Price, select the currency and enter a Price value for the Product Variant.
        The Price field allows high-precision prices. High-precision prices contain more digits after the decimal separator than the default for the selected currency.
        If an active Product Discount affecting the Product Variant exists, the discounted Price is displayed in the Discounted price section.

      • Optional: Together with the currency, the following fields form a Price scope that determines the uniqueness of the Price for the Product Variant.

        A Product Variant cannot have two Prices with the same Price scope.

        • For Country, select a country for which the Price is applicable.
        • For Customer Group, enter a Customer Group for which the Price is applicable.
        • For Channel, enter a Channel for which the Price is applicable.
        • For Price valid from, enter a date and time from which the Price is valid.
        • For Price valid to, enter a date and time until when the Price is valid.
          The Price valid from and Price valid to values are used to select a Price for a Product Variant when it is added to the Cart, they are not used to remove Prices that are no longer valid. Prices that are no longer valid are not automatically removed, but they can be removed if necessary.
    2. Optional: If a Custom Field is defined for the Price, select it from the drop-down in the Custom fields section, and depending on the field type, enter or select the value for it.
      Custom Fields are implemented using the Custom Fields API.
    3. Optional: To add pricing for bulk or volume orders, click Add price tier in the Price tiers section and enter the following details:
      • For Price, enter a Price value that should apply when the line entry in the Cart matches the minimum quantity.
        The Price field allows high-precision prices. High-precision prices contain more digits after the decimal separator than the default for the selected currency.
      • For Min. quantity, enter the minimum quantity that should be met for the Price tier to apply.

        If no Price tier is defined, the base Price is used.

    4. Click Save.
  5. Close the Add embedded price window and update the status to Publish in the Product page.
    Modified status of the Product when a new Price is added to it.

Price list

Every Product Variant has its own Price list that displays their full-sale Prices in the defined currency along with their country, Customer Group, Channel, or validity period for a Price, if configured for that Price. If defined, the Price list also displays the Price tier, as well as discounted Prices, if affected by an active Product Discount.

To access a Price list, follow these steps:

  1. Go to Products > Product list and select the Product for whose Product Variants you want to access Prices.
  2. In the Variants tab, select the Product Variant and click the Prices tab.
To remove columns, click the Table settings drop-down, select Column manager and drag the cards to the Hidden columns. To reorder columns, move the cards up or down the stack accordingly.

Delete a Price

  1. Go to Products > Product list and select the Product that contains the Product Variant you want to delete the Price from.
  2. In the Variants tab, select the Product Variant.
  3. In the Prices tab, select the Price and click Delete in the Manage the price window.

Standalone Price

Unlike Embedded Prices, you can create Standalone Prices for Products that do not exist in the Project. In such cases, to link newly added Product Variants with a Standalone Price, both the Product Variant and Standalone Price must have the same SKU.

Add a Price

Standalone Prices can also be created for Products having Embedded Prices.

  1. Go to Prices > Add Standalone Price.
  2. On the Create Standalone Price page, follow these steps:
    1. In the General information section, for SKU, enter the Product Variant's SKU. Standalone Prices are associated to a Product using its SKU value.

      The SKU cannot be updated after the Price is saved.

    If the entered SKU already exists for a Product Variant, its related Product and current Price Mode are displayed in Product price mode.
    By clicking on the displayed Product, you can jump to the related Product details' page.
  3. In the Price information section, follow these steps:
    • Optional: For Price key, enter a unique identifier that helps identify the Standalone Price.
    • For Price, select the currency (if more currencies are configured for the Project) and enter a Price value for the Product Variant.
      This field supports high precision prices, which allows a higher number of fraction digits for the selected currency than its default.
      If an active Product Discount exists for the Product Variant, the discounted Price is displayed in the Discounted price section.
    • Optional: For Staged Price, select the currency (if more currencies are configured for the Project) and enter a staged Price value for the Product Variant.
      If an active Product Discount exists for the Product Variant, the discounted staged Price is displayed in the Discounted price section.

    • Optional: Together with the currency, the following Price scopes determine the uniqueness of the Price for the Product Variant.

      • For Country, select a country for which the Price is applicable.
      • For Customer group, enter a Customer Group for which the Price is applicable.
      • For Channel, enter a Channel for which the Price is applicable.
      • For Price valid from, enter a date and time from which the Price is valid.
      • For Price valid to, enter a date and time until when the Price is valid.

      A Product Variant cannot have two Prices with the same combination of Price scopes.

      The Price scopes cannot be edited after a Price is created.

  4. Optional: If a Custom Field is defined for the Price, select it from the drop-down in the Custom fields section, and depending on the field type, enter or select the value for it.
    Custom Fields are implemented using the Custom Fields API.
  5. Optional: To add pricing for bulk or volume orders, in the Price tiers section, click Add price tier and enter the following details:
    • For Price, enter a Price value that should apply when the line entry in the Cart matches the minimum quantity.
      This field supports high precision prices, which allows a higher number of fraction digits for the selected currency than its default.
    • For Min. quantity, enter the minimum quantity that should be met for the Price tier to apply.

      If no Price tier is defined, the base Price is used.

  6. Click Save. By default, Standalone Prices created are active and thus, visible to customers.
    However, unlike Embedded Prices, their visibility can be adjusted. For more information, see Deactivate a Price.
To apply the staged changes for the Standalone Price, see Apply the staged changes.

Standalone Price list

The Standalone Prices list displays the full-sale Prices of Product Variant SKUs in the defined currency along with their country, Customer Group, Channel, or validity period for a Price, if configured for that Price. If defined, the Price list also displays the Price tier, as well as discounted Prices, if affected by an active Product Discount. The list also displays the status of the configured Standalone Prices.

Deactivate a Price

  1. Go to Prices > Standalone Price list and select the SKU for which you want to deactivate the Price.
  2. On the Manage Standalone Price page, click the Status toggle when active.
  3. In the Deactivate price dialog, click Deactivate price.

Delete a Price

  1. Go to Prices > Standalone Price list and select the SKU for which you want to delete the Price.
  2. On the Manage Standalone Price page, click the delete icon.
  3. In the Delete Price dialog, click Delete Price.

Add a staged value for an existing Standalone Price

  1. Go to Prices > Standalone Price list and select the SKU for which you want to set a staged Price.
  2. In the Price information section on the Manage Standalone Price page, for Staged Price, select the currency (if more currencies are configured for the Project) and enter a staged Price value for the Product Variant.
    This field supports high precision prices, which allows a higher number of fraction digits for the selected currency than its default.
    If an active Product Discount exists for the Product Variant, the discounted staged Price is displayed in the Discounted price section.
  3. Click Confirm. This saves the staged Price for the respective SKU.

Apply the staged changes

You can apply staged changes only if there are no other unsaved changes on the page.

  • To apply the staged changes, click Apply staged changes. Note that this replaces the existing base Price of the SKU with the staged value.

Choose the Product Price mode

During checkout, the Price of a Line Item Price is determined based on the following factors:

  • The Product Price mode, which determines the type of Price that must be considered. Composable Commerce uses Embedded Prices, as the default, for a Product Price.
  • Price scopes, which determine the uniqueness of the Price based on the distribution channel, currency, country, and Customer Group.

To choose the Product Price mode used, do the following:

  1. Go to The Products > Product list and select the Product.
  2. In the General information section on the Product detail's page, for Product price mode, select the type of Price to be used for the Product at checkout.
  3. Click Save.