1. Home
  2. Knowledge Base
  3. Getting Started
  4. Getting started with WooCommerce Wholesale Prices Premium

Getting started with WooCommerce Wholesale Prices Premium

WooCommerce Wholesale Prices Premium

Setting wholesale prices product by product gets slow once your catalog grows. WooCommerce Wholesale Prices Premium adds store-wide and category discounts, more wholesale roles, visibility rules, shipping and payment mapping, minimum orders and wholesale tax options on top of the free plugin.

This guide walks you through each of these, starting with a store-wide discount you can set in one step. When you finish, your wholesale customers see the right prices, products and checkout options for their role.

Prefer video? Watch the walkthrough below. It was recorded before the settings screen was redesigned, so some screens differ from the screenshots in this guide.

Subscribe to Wholesale Suite

Requirements

  • WooCommerce installed and active
  • WooCommerce Wholesale Prices (free) installed and active. Premium needs it to run.
  • WooCommerce Wholesale Prices Premium installed, activated and licensed
  • An Administrator account. A Shop Manager can change Wholesale → Settings, but only an Administrator can open Wholesale → Roles.

Step 1: Set a store-wide wholesale discount

The fastest way to give wholesale customers their prices is a percentage discount for each wholesale role. It applies across your whole catalog, so you don’t need to edit each product.

  1. Go to Wholesale → Settings.
  2. Click the Wholesale Prices tab, then the Discount sub-tab.
  3. Under General Discount Options, pick a role in Wholesale Role.
  4. Enter the discount in Percent Discount. For 25% off, enter 25.
  5. Click Add Mapping. The role and its discount appear in the table below.

This general discount applies only when a product has no wholesale price of its own and no category discount. Step 3 explains this order.

The Wholesale Prices Discount settings sub-tab where you set a store-wide wholesale percentage discount per wholesale role

Right after you activate Premium, a Set a wholesale discount in one step notice shows on Wholesale Suite and WooCommerce admin screens. Its Set a wholesale discount button opens this same Discount sub-tab. The notice goes away when you dismiss it or once any wholesale pricing is set. It needs Wholesale Prices Premium 2.1.2 or later.

Step 2: Add more wholesale roles

Each wholesale role can have its own prices, minimum orders, shipping and payment options. Stores often add roles to separate local and overseas buyers, or to set up tiers such as Bronze, Silver and Gold.

  1. Go to Wholesale → Roles.
  2. Under Add New Wholesale Role, enter a Role Name, for example Distributor.
  3. Optionally, enter a Role Key and a Description.
  4. Click Add New Wholesale Role. The role appears in the roles table.
The Wholesale Roles page with the Add New Wholesale Role form and three wholesale roles in the table

Each role gets its own price fields on every product. Open a product. Under Wholesale Prices in the product data, enter a Wholesale Price ($) for each role.

The Wholesale Prices fields on a product, with a different wholesale price for the Wholesale Customer, Distributor and VIP Wholesale roles

Plan your roles before you set prices. For more detail, see how to add more wholesale roles.

Step 3: Learn how wholesale pricing levels work

The free plugin sets a wholesale price on each product. Premium adds a percentage discount per product category and the store-wide discount from Step 1. It also adds quantity-based pricing, where the price drops as the customer buys more.

When more than one price applies to a product, the most specific one wins. The plugin checks them in this order and uses the first one it finds:

  1. The product’s own wholesale price
  2. A category percentage discount
  3. The store-wide percentage discount

For example, say you set a 20% store-wide discount and a fixed wholesale price on one product. That product uses its fixed price, and every other product gets 20% off.

For the full rules, including quantity-based pricing, see the wholesale pricing guide.

Step 4: Control which products wholesale customers see

You can hide retail products from wholesale customers, and keep wholesale-only products or variations away from other customers.

Show only wholesale products to wholesale customers

  1. Go to Wholesale → Settings.
  2. Click the Wholesale Prices tab, then the General sub-tab.
  3. Under Wholesale Products, tick Only Show Wholesale Products To Wholesale Customers.
  4. Click Save Changes.

Wholesale customers then see only products that have a wholesale price. A price from a category or store-wide discount counts. Retail customers are not affected.

The Wholesale Products settings with Only Show Wholesale Products To Wholesale Customers ticked

Restrict a product to some wholesale roles

  1. Open the product in Products → All Products.
  2. In the Publish box, find Restrict To Wholesale Roles.
  3. Select one or more roles.
  4. Click Update.

Only customers with a selected role can see the product. Use this to sell some products only to some groups, for example only to overseas distributors.

The product Publish box with Restrict To Wholesale Roles set to Wholesale Customer and Distributor

Make a variation wholesale-only

  1. Open a variable product.
  2. Click Variations in the product data.
  3. Expand the variation.
  4. In Wholesale Exclusive Variation, select one or more roles.
  5. Click Update.

Only customers with a selected role can buy that variation. Leave the field empty to make the variation available to everyone.

The Wholesale Exclusive Variation field on a product variation, set to Wholesale Customer and VIP Wholesale

For more options, see the product visibility guide.

Step 5: Map shipping methods and payment gateways

A mapping links a shipping method or payment gateway to a wholesale role, so that customers with the role see only the options you choose.

Shipping methods

Shipping mapping works with your WooCommerce shipping zones, so you can set shipping per area and per role. For example, offer Local pickup in your local zone to wholesale customers only.

  1. Go to Wholesale → Settings.
  2. Click the Wholesale Prices tab, then the Shipping sub-tab.
  3. Under Wholesale Role / Shipping Method Mapping, choose a Wholesale Role.
  4. In Shipping Zones, choose a zone.
  5. In Shipping Zone Methods, choose the method.
  6. To hide the method from retail customers, set Wholesale Only? to Yes.
  7. Click Add Mapping.

Repeat for each role and zone. The mapping shows in the table below the form.

The Wholesale Role / Shipping Method Mapping form and table, with Local pickup mapped to Wholesale Customer and Flat rate mapped to Distributor

For the full setup, see how to restrict wholesale customers to particular shipping methods.

Payment gateways

  1. Go to Wholesale → Settings.
  2. Click the Wholesale Prices tab, then the Payment Gateway sub-tab.
  3. Under Wholesale Role / Payment Gateway, choose a Wholesale Role.
  4. In Payment Gateways, select one or more gateways.
  5. Click Add Mapping.

The gateway does not need to be enabled in WooCommerce. A mapped gateway shows at checkout for that role even when it is turned off for everyone else. For example, map Direct bank transfer to your wholesale roles to offer it only to them.

The Wholesale Role / Payment Gateway mapping table, with Direct bank transfer and Check payments mapped to wholesale roles

To add a fee for a gateway, use Wholesale Role / Payment Gateway Surcharge on the same screen. For more, see how to restrict wholesale customers to particular payment gateways.

Step 6: Set minimum order requirements

Minimum order requirements hold back wholesale prices until the cart reaches a set quantity, a set subtotal, or both.

  1. Go to Wholesale → Settings.
  2. Click the Wholesale Prices tab, then the General sub-tab.
  3. Under Order Requirements, enter a Default Minimum Order Quantity, a Default Minimum Order Subtotal, or both.
  4. If you set both, choose Require Quantity AND Subtotal or Require Quantity OR Subtotal.
  5. Click Save Changes.
The Order Requirements settings with a default minimum of 10 items and a 500 dollar subtotal, and a role-specific rule for VIP Wholesale

To give a role its own minimums:

  1. Set Wholesale Role Specific Minimum Requirements to Enabled.
  2. Choose a Wholesale Role.
  3. Enter a Minimum Order Quantity and a Minimum Sub-total Amount ($).
  4. Choose the Minimum Order Logic.
  5. Click Add Mapping.

Roles without a mapping use the defaults.

Until the cart meets the minimum, customers can still add products. The cart shows retail prices and a notice that says what the customer still needs:

The cart notice telling a wholesale customer they have not met the minimum order quantity and subtotal, with retail prices shown

This lets a wholesale customer place a small order at retail prices when they need to. For the reasons, see why the cart shows retail prices until the minimums are met. To block checkout until the minimum is met, see how to prevent purchase if wholesale conditions are not met.

Step 7: Set up wholesale tax

The wholesale tax settings control how WooCommerce tax applies to your wholesale roles: how prices display, and which roles pay tax. They don’t set tax rates. Set up your tax rates and tax classes in WooCommerce first, as shown in Setting up taxes in WooCommerce.

Check your local rules for how wholesale prices and tax must be shown.

  1. Go to Wholesale → Settings.
  2. Click the Wholesale Prices tab, then the Tax sub-tab.
  3. Under Tax Options, set Display Prices in the Shop to Including tax or Excluding tax.
  4. Set Display Prices During Cart and Checkout to Including tax or Excluding tax.
  5. Optionally, enter a Wholesale Price Suffix, for example excl. GST.
  6. Click Save Changes.
The wholesale Tax Options with prices shown excluding tax, an excl. GST wholesale price suffix and the Front End Tax Toggle

The same screen has more tax options:

  • Tax Exemption: tick Do not apply tax to all wholesale roles to remove tax for every wholesale role. The two display settings above are then ignored, and wholesale prices show excluding tax.
  • Front End Tax Toggle: lets customers switch product prices between including and excluding tax. It needs Wholesale Prices Premium 2.1.4 or later, and WooCommerce taxes must be turned on.
  • Wholesale Role / Tax Class Mapping: sets which tax classes each wholesale role uses.

Exempt only some roles from tax

Use Wholesale Role / Tax Exemption Mapping on the same screen. A mapping overrides the general Tax Exemption option for that role.

  1. Choose a Wholesale Role.
  2. Set Tax Exempted? to Yes.
  3. Click Add Mapping.
The Wholesale Role / Tax Exemption Mapping table with the Distributor role tax exempted

For more, see how to make a wholesale role tax exempt.

Step 8: Track your setup in the checklist

The setup checklist needs Wholesale Prices 2.3.0 or later and Wholesale Prices Premium 2.1.4 or later.

The Wholesale → Dashboard page shows a Get Started with Wholesale Prices checklist, with one section for each Wholesale Suite plugin you have active. The Wholesale Prices Premium section ticks its items for you as you set things up.

One item counts toward finishing the section:

  • Set wholesale pricing: ticks when you set a wholesale price on a product, or a store-wide or category discount for a wholesale role. Its Set a wholesale discount link opens the Discount sub-tab from Step 1.

The optional group, marked not counted, lists more Premium features to try: Add another wholesale role, Set minimum order requirements, Set tax handling for wholesale, Set payment & shipping per role and Explore wholesale Reports. Each item links to the matching screen.

The Get Started checklist on the Wholesale Suite Dashboard with the Wholesale Prices Premium section expanded, showing Set wholesale pricing and the optional items

Premium also emails the store admin twice: Your wholesale pricing is live when you save your first Premium pricing rule, and Your wholesale pricing is set up when the section is complete. To turn these off, disable Wholesale Premium onboarding: first pricing rule set and Wholesale Premium onboarding: setup complete under WooCommerce → Settings → Emails.

Other Wholesale Suite plugins add their own sections. For example, Wholesale Order Form 3.1.3 or later adds Create your first order form and Put the form on a published page. To hide the checklist for good, click Don’t show this again at the bottom of it.

What’s next

Frequently asked questions

What is WooCommerce Wholesale Prices Premium and what does it do?

WooCommerce Wholesale Prices Premium is the paid add-on plugin for the free WooCommerce Wholesale Prices plugin. It adds more wholesale user roles, percentage-based and quantity-based pricing, product visibility controls, wholesale shipping and payment gateway mapping, minimum order requirements, and wholesale tax settings.

Can I set different wholesale pricing levels for different types of wholesale customers in WooCommerce?

Yes. WooCommerce Wholesale Prices Premium lets you create multiple wholesale user roles such as Bronze, Silver, Gold and Platinum, so you can assign different wholesale pricing, minimum order requirements, shipping methods, and payment gateways to each group. For example, you can give local and international buyers their own roles.

How does wholesale pricing work in WooCommerce Wholesale Prices Premium?

The plugin uses the first price it finds: the product’s own wholesale price, then a category percentage discount, then the store-wide percentage discount. This means you can set a store-wide wholesale discount and still override prices for specific products or categories.

Can I restrict which products wholesale customers see in my WooCommerce store?

Yes. WooCommerce Wholesale Prices Premium includes product visibility controls. You can enable the Only Show Wholesale Products To Wholesale Customers setting so wholesale customers only see products with wholesale pricing assigned. You can also restrict individual products or product variations to specific wholesale roles, so some products are only for some customer groups.

Does WooCommerce Wholesale Prices Premium support wholesale-specific shipping and payment gateways?

Yes. The plugin’s shipping method mapping and payment gateway mapping features let you assign specific shipping methods and payment options to individual wholesale user roles. For example, you can offer the Local pickup shipping method only to local wholesale customers, or offer Direct bank transfer only to wholesale buyers.

Need help?

If you have a question or run into any issues, we’re here to help.

Was this article helpful?

Related Articles

Complete Your Purchase