Wholesale prices and minimum purchase quantities for products can be configured in X-Cart 5 using the addon Wholesale.

Wholesale prices are a way to offer multiple levels of pricing for the same product depending on the membership level of the buyer and the quantity of product units ordered.

In case wholesale pricing can be tired to a specific minimum purchase quantity for a product and can be offered to the customers with a particular membership level as well as to every customer in a store. A minimum purchase quantity is a minimum number of product units that can be bought by a customer at a time. If a customer’s cart contains less items than the set minimum purchase limit, checkout for the cart is not allowed.

Before you proceed, make sure the addon Wholesale is installed and enabled. 540-wholesale-on.png

Minimum Purchase Quantities Setup

Minimum purchase quantity defines the minimum number of product units that are to be added to cart in order for the checkout option to become available. Minimum purchase quantity is set on a per product basis and is displayed on the related product details page in the storefront provided the “Wholesale” addon is installed and enabled.

The minimum product purchase quantities can be set via the Inventory tracking tab of the chosen product’s details:

  1. Select a product to edit on the product listing page (Catalog -> Products) of your store Admin area.

  2. Open the Inventory tracking tab of the product details page. inventory-tracking.png

  3. On the page that opens, use the Minimum purchase quantity section to specify a minimum purchase quantity for every available membership level and for “all customers” (users without a membership): minimum-purchase-quantity.png

  4. Click Update to save the changes.

By default, the minimum purchase quantity value is set to 1 for all customers, either with or without a specific membership. When a store admin changes this value to any different from 1, this info is displayed on the product details page in the storefront for the customers with the respective membership level (or for all customers, if the minimum purchase quantity value is changed for the users without a membership):


If a product with the changed minimum purchase quantity value is added to cart directly from any product listing page (home page, category page, etc.) it is added to cart in the amount specified as minimum purchase quantity value for this product in the Admin area.

Wholesale Prices Setup

Wholesale prices can be configured for the store as a whole (the “all customers” level) and for a particular customer membership level. When assiging wholesale prices for memberships make sure the relative memberships are configured accordingly.

To configure wholesale prices:

  1. In your store’s Admin area, find the product for which you want to set or modify wholesale prices and open its details.

  2. Switch to the Wholesale pricing tab of the product details page.  540-wholesale-prices-tab.png

  3. Add the wholesale pricing tiers you require.

    For each new tier complete the following steps:

    1. Click the New tier button: 540-new-tier.png

      This adds a new blank line to the wholesale pricing table: 540-tier-setup.png

      The Tier-1 line is generated automatically based on the product details info and can not be edited. The changes of the Minimum purchase quantity value are not reflected in the Tier-1 line in your store Admin Area. However, they are displayed in the wholesale prices table on the product details page in the storefront provided wholesale prices are configured for this product.

    2. On the line that has appeared, provide information about the new wholesale pricing tier:
      • Specify the number of product units starting from which the price of this tier should become available.
      • Specify the tier price - as a fixed value or as a percentage of the unprivileged Tier-1 price (Quantity range = “from 1”, Membership = “All customers”).
      • Specify the membership level that should provide customers access to the tier price.
    3. Click Save changes

      The new tier will be added to the table: 540-tier-added.png

The product details page in the storefront with the configured wholesale prices for a product will look as follows:

Default minimum product quantity540-cus-details-page-2.png
Altered minimum product quantity540-cus-details-page-1.png

Configuration Samples

Now let us take a closer look at how you configure specific pricing tiers. Consider the following example:

We have a product that we want to sell, and we want to define pricing tiers for it so that customers without a membership would be able to purchase the product at the following prices:

  • 1-9 units - $50
  • 10-99 units - $49
  • 100+ units - $47

(As you can see, the more units of the product is purchased, the lower the price).

We also have a privileged ‘Wholesaler’ membership level to which we want to give even lower prices:

  • 1-1000 units - $45 (a 10% discount off the unprivileged Tier-1 price, $50)
  • 1001+ units - $42.5 (a 15% discount off the unprivileged Tier-1 price, $50)

How do we configure pricing tiers?

In this case, we need to create and set up pricing tiers as follows:

    • Quantity range: from 1
    • Price: $50
    • Membership: All customers
    • Quantity range: from 10
    • Price: $49
    • Membership: All customers
    • Quantity range: from 100
    • Price: $47
    • Membership: All customers
    • Quantity range: from 1
    • Price: $45 or 90%
    • Membership: Wholesaler
    • Quantity range: from 1000
    • Price: $42.5 or 85%
    • Membership: Wholesaler