Smart Role Based Pricing (version 1.0.10) lets one WooCommerce shop show different prices to different people: a trade price for wholesale buyers, a little extra off for loyal customers, or a lower price per item when a shopper buys more.
Everything runs on pricing rules. A rule is one sentence, such as “Wholesale customers get 20% off everything in the Shoes category”. You fill in a short form, save it, and shoppers see their own price on the product page, in the cart and at checkout.
You will find the plugin under WooCommerce > Settings > Role pricing. That tab has seven sub-pages:
| Sub-page | What it is for |
|---|---|
| Pricing rules | The list of every rule, with status, type, priority, orders used on and schedule |
| Add new rule | The form for creating a rule |
| Role price matrix | One table of products against customer types |
| Rule simulator | Preview a price without logging in as a customer |
| Analytics | Savings and the most used rules |
| Import / Export | Back up and move rules |
| Settings | Store-wide switches: hidden prices, quote requests, product page display, performance |
When more than one rule could apply, rules run in priority order, lower numbers first.
Installation
↑ Back to topTo start using a product from WooCommerce.com, you can use the โAdd to storeโ functionality on the order confirmation page or the My subscriptions section in your account.
- Navigate to My subscriptions.
- Find the Add to store button next to the product youโre planning to install.
- Follow the instructions on the screen, and the product will be automatically added to your store.
Alternative options and more information at:
Managing WooCommerce.com subscriptions.
Quick start: your first rule
↑ Back to topThe fastest way to learn the plugin is to give wholesale customers 20% off. The rule form is numbered 1 to 6, so you can follow it from top to bottom.
- Open WooCommerce > Settings > Role pricing.
- Click Add new rule and type a name only you will see, for example “Wholesale customers 20% off”.
- Under 2. Which products does this rule apply to? leave Every product in the store, or pick products, categories, or tags.
- Under 3. Choose how the price changes choose Discount by percentage and type
20in the amount box. Type the number only, without a % sign. - Under 4. Who gets this price? tick Wholesale.
- Add any conditions (section 5) or quantity tiers (section 6) if you need them.
- Check Status (in the right column) is Turned on, then click Save rule.
- Open Rule simulator, choose a product and the Wholesale role, and confirm the price. Then visit the shop as a Wholesale customer to see it live.
The amount box starts with a 0 in it. Select it and replace it, otherwise you may end up with 020.
The rule form, section by section
↑ Back to topEvery feature below is a setting on the Add new rule form. This table shows where to find each one.
| Where | What it holds |
|---|---|
| 1. Name and describe this rule | Rule name (only you see it), private notes, and optional custom badge text shown to customers |
| 2. Which products does this rule apply to? | Every product, specific products, categories, tags or specific variations, plus an optional exclusion list |
| 3. Choose how the price changes | The kind of price change and the amount or formula |
| 4. Who gets this price? | User roles, Guests (not logged in) and Specific customers |
| 5. Choose when this discount should apply | Optional conditions |
| 6. Quantity discounts | Optional quantity tiers: Buy at least, Up to, Type, Amount |
| Status & schedule (right column) | Status, start date, end date, priority, Stop checking other rules, and a limit on orders |
| Order quantity constraints (right column) | Minimum quantity, Maximum quantity and Step |
Click Save rule (right column) when you are done. Nothing is applied until you save.
Feature 1: Prices for different types of customers
↑ Back to topGive each type of customer on your site its own price: wholesale buyers, members, staff, or regular shoppers. You can even set a price just for visitors who have not logged in.
Useful when: you sell to both the public and to businesses, or you run a membership and want members to see a better price.
How to set it up
- On the rule form, go to 4. Who gets this price?
- Tick one or more roles, such as Customer, Wholesale, or Subscriber. Tick Guests (not logged in) to target visitors who have not signed in.
- Set the price change in section 3 and save the rule.
If you leave every box unticked the rule applies to every shopper. Anyone you do not select simply pays the normal price. This does not hide the price from them.
Example: everyone pays $50 for a jacket, but customers with the Wholesale role pay $35.
Feature 2: Prices for one particular customer
↑ Back to topPick one or more named customers and give them their own price, no matter what type of customer they are.
Useful when: you have agreed a special deal with a big client or a long-time customer and want to honour it without changing prices for anyone else.
How to set it up
- On the rule form, go to 4. Who gets this price?
- In the Specific customers (optional) box, search by name or email and pick the customer.
- Set the price change in section 3 and save the rule.
To check it, open the Rule simulator. It has an optional Specific customer field that overrides the role, so per-customer rules apply.
Example: Sarah’s Cafe always gets coffee beans at $12 a bag, while other trade customers pay $14.
Feature 3: Choosing which products a rule covers
↑ Back to topDecide where a price change applies: every product, a few chosen products, whole categories, products with a certain tag, or a single size or colour of a product. You can also leave some products out.
Useful when: you want a discount on most things but not on items that are already on sale, or only on one product line.
How to set it up
- In section 2. Which products does this rule apply to?, open the Apply to list.
- Choose one of: Every product in the store, Specific products, Products in specific categories, Products with specific tags, or Specific product variations.
- If you picked anything other than every product, start typing in the Which ones? box and pick one or more items.
- To carve products out, use the Exclude products from this rule (optional) panel: Skip these products, Skip products in these categories and Skip products with these tags. A product is excluded if it matches any of the three.
To give “10% off everything except new arrivals”, leave the targeting on Every product and list the exceptions in the exclusion panel. Smaller categories inside a chosen category are included automatically.
Example: 15% off everything in “Clothing”, except gift cards. A smaller category such as “Shirts” is included automatically.
Feature 4: Different ways to change the price
↑ Back to topChoose how the new price is worked out. A wholesaler might get a fixed price list, while a member gets a simple percentage off. Raising prices is handy for something like a small handling charge for one customer group.
How to set it up: in section 3. Choose how the price changes, pick a type under What kind of price change?, then fill in the amount.
| Type in the list | Amount box | Result |
|---|---|---|
| Discount by percentage (e.g. 10% off) | 10 | 10% off the price |
| Increase by percentage (e.g. 10% markup) | 10 | 10% added |
| Discount by a fixed amount (e.g. $5 off) | 5 | $5 off |
| Increase by a fixed amount | 5 | $5 added |
| Set a fixed price | 20 | The price becomes $20, full stop |
| Use a custom formula | A formula | Your own simple sum |
Type the number only, with no % or currency sign.
Custom formulas. Use {price} for the regular price, {qty} for the quantity and {subtotal} for the cart subtotal. Only + – * / and parentheses are allowed. For “price times 0.9, plus 5” write {price} * 0.9 + 5.
Features 5 and 6: Buy more, save more, with live price updates
↑ Back to topLower the price per item as the shopper buys more of it. A “Buy more, save more” table appears on the product page, so shoppers see the deal at a glance. As the shopper changes the quantity box, the product page updates the price, the amount saved and the total straight away. The matching row in the table lights up, and a hint such as “Add 6 more to pay $8.64 each” can appear. The plugin also counts what is already in the shopper’s cart.
Useful when: you want to encourage bigger orders, or you sell things people often buy in bulk. Seeing the saving straight away often nudges shoppers to add one or two more.
How to set it up
- On the rule form, scroll to 6. Quantity discounts (optional).
- Click + Add quantity tier.
- Fill in Buy at least (the first quantity of the tier) and Up to (leave blank for no maximum).
- Choose a Type (for example Discount by percentage) and an Amount.
- Add more tiers with + Add quantity tier, then save the rule.
The quantity counts every cart line of the product the rule covers. Items with different add-on options, or different variations of a product the rule covers as a whole, count together.
What shoppers see. In the demo store, Fresh Mango shows a table with three tiers: 3 to 5 at $9.72, 6 to 11 at $9.18 and 12 or more at $8.64. With a quantity of 6 the 6 to 11 row is highlighted and the line under the quantity box reads “6 x $9.18 = $55.08” with a “Bulk price applied” note.
Turning live updates off. If you prefer the price to stay still, switch it off under Settings > Product page display (Role pricing tab).
Example: 1 to 4 mugs cost $10 each, 5 to 9 cost $9 each, and 10 or more cost $8 each.
Feature 7: Only when certain things are true (conditions)
↑ Back to topSay that a price only applies when something else is true.
Useful when: you want deals like “spend $150 and save 10%”, weekend specials, “happy hour from 5 to 7pm” or “5% off when you pay by bank transfer”.
How to set it up
- On the rule form, go to 5. Choose when this discount should apply (optional conditions).
- Click + Add condition.
- Open the first list and choose a condition. Then choose how to compare it (for example “is”) and type the value.
- Add more conditions with + Add condition. Use the x at the end of a row to remove one.
If you leave this section empty, the discount applies all the time.
Conditions you can choose from
| Condition | Use it for |
|---|---|
| Customer role | A certain type of customer |
| Specific customer | One named customer |
| Customer is logged in | Logged-in shoppers only |
| Cart subtotal | The cart total is over a certain amount |
| Total items in cart | The cart has a certain number of items |
| Quantity of this product | The shopper buys a certain number of one product |
| Customer’s number of orders | Loyalty after a number of orders |
| Customer country | The shopper is in a certain country |
| Chosen shipping method | A delivery method |
| Chosen payment method | A payment method |
| Current date / time | A certain date, time or time of day |
| Day of the week | A certain day of the week |
| This is the customer’s first order | New customers (Feature 8) |
| Returning customer | Customers who have ordered before (Feature 8) |
Feature 8: Rewarding new and loyal customers
↑ Back to topGive a price only to someone placing their very first order, only to people who have ordered before, or only to people who have placed a certain number of orders.
Useful when: you want a welcome discount for new shoppers, or a thank-you for regulars. Guests are recognised by their email address, so the same person cannot keep claiming a first-order deal.
How to set it up
- On the rule form, go to section 5 and click + Add condition.
- Choose one of: This is the customer’s first order, Returning customer or Customer’s number of orders.
- For a number of orders, choose how to compare it and enter the number.
- Set the price change in section 3, choose who gets it in section 4, and save.
Example: 10% off your first order, and 15% off once you have ordered five times. Make this two rules: one with the first-order condition at 10%, and one with Customer’s number of orders set to five at 15%.
Feature 9: Minimum, maximum and “packs of” quantities
↑ Back to topSet the smallest and largest number a customer can order, and make them order in steps, such as boxes of 12.
Useful when: wholesale customers must buy at least 10 units, a product ships only in full cases, or you want to stop one person buying all your limited stock.
How to set it up
- On the rule form, find the Order quantity constraints panel in the right column.
- Fill in Minimum quantity and Maximum quantity. Leave a field blank to skip that limit.
- Fill in Step (must order in multiples of). For example, 12 forces the shopper to add 12, 24, 36, and so on.
- Choose who the limits apply to in section 4, then save.
The limits apply when the rule applies to a shopper, and force the cart quantity for matching products into that range.
The plugin will not let you save limits that make a product impossible to buy, such as a minimum of 10 and a maximum of 5.
Example: trade customers can order wine in 6, 12, 18, and so on, but not 7. Set Step to 6.
Features 10 and 11: hiding prices and request a quote
↑ Back to topHide prices from visitors who are not logged in, or from certain types of customers. In place of the price they see a short message of your choice. When prices are hidden, visitors can send a quick “Request a quote” message from the product page. You get an email, and every request is also saved in your dashboard.
Useful when: you are a trade-only supplier, your prices are only for approved accounts, or you would rather talk to new buyers before giving them a price.
Part 1: hide prices (Role pricing > Settings > Price visibility)
- Under Hide prices from these user roles, tick the roles that should not see prices. Tick Guest (logged-out visitor) to hide prices from visitors who are not logged in.
- In Message shown when a guest cannot see prices, write your message. The default is “Log in to see your price”.
- Click Save Changes.
Selected roles see your message instead of the price, and the Add to Cart button is hidden for them. To hide the price of a single product, use that product’s own setting on its edit screen. The Settings page notes that per-product overrides live there.
Part 2: offer a quote form (Role pricing > Settings > Quote requests)
- Under Let guests request a quote when prices are hidden, choose Yes, offer a quote form.
- Set the Quote button label (default “Request a quote”) and the Quote thank-you message shown after a request is sent.
- In Send quote notifications to, enter the email address that should receive requests. Leave it empty to use the site admin email.
- Click Save Changes.
Where requests arrive. Each request is emailed to you and saved under WooCommerce > Quote requests. The list shows From, Status, Email, Message, Product, Page, and Date. The View quote requests link on the settings panel opens the same list.
Feature 12: Scheduling, order of rules and usage limits
↑ Back to topGive a rule a start and end date so it switches on and off by itself, decide which rule is checked first, stop the shop checking other rules once one has been used, and limit how many orders a rule can be used on.
Useful when: you are planning a Black Friday sale ahead of time, running “first 100 orders get 20% off”, or making sure two deals do not stack on top of each other.
Where to find it: the Status and schedule panel in the right column of the rule form.
| Setting | What it does |
|---|---|
| Status | Turned on, Turned off, Scheduled or Archived |
| Start date (optional) | The rule switches on at this date and time |
| End date (optional) | The rule switches off at this date and time |
| Priority (lower numbers run first) | The order rules are checked in. New rules start at 10 |
| Stop checking other rules if this one matches | Rules with a higher priority number are skipped once this one has changed the price |
| Limit how many orders this rule can be used on (optional) | Stops the rule after that many orders |
Good to know
- A use is counted once per order, however many products in that order the rule discounts.
- The use is handed back if the order is cancelled, fails, or is deleted.
- If a rule only discounts at certain quantities, Stop checking other rules stops nothing below those quantities, so your other rules still apply.
- The Pricing rules list shows each rule’s Priority, Orders used on and Schedule, and has a Scheduled filter.
Feature 13: Easy rule management
↑ Back to topSee all your rules in one list, switch them on or off, copy a rule to make a similar one, and change or delete many rules at once. Each rule also has a notes box just for you.
Useful when: you have lots of deals running and want to keep things tidy, or you want to reuse last year’s sale as a starting point.
The Pricing rules list
- The columns are Rule name, Status, Type, Priority, Orders used on and Schedule.
- Use the links above the list to filter by All, Turned on, Turned off, Scheduled or Archived.
- Type in the search box and click Search rules to find a rule by name.
Bulk actions
- Tick the box beside each rule you want to change, or the box in the header to select all.
- Open Bulk actions and choose Turn on, Turn off, Duplicate or Delete.
- Click Apply.
Reusing a rule. Duplicate the rule, open the copy, then change its name, dates, or amounts.
Private notes. Section 1 of the rule form has Notes for yourself (optional). Customers never see it.
Features 14 to 16: What shoppers see
↑ Back to topFeature 14: Clear price labels. Shoppers see the normal price crossed out next to their special price, a “You save” note, and a small badge such as “Wholesale price” or “Member price”. You can write your own badge text. Hovering or tapping the badge shows a short “why this price” explanation. A visible saving feels much better than a quietly lower number.
- Custom badge text: section 1 of the rule form has Custom badge text shown to customers (optional).
- Switches: under Role pricing > Settings > Product page display you can turn on or off the crossed-out regular price, the pricing badges and the hover explanation. The explanation only ever shows the shopper’s own reason, never another customer’s or another role’s price.
Feature 15: “Price by role” table on the product page. A small table lists what each customer type pays, with the shopper’s own price marked. Seeing “Members pay $40” next to “You pay $50” is a gentle push to become a member. In the demo store it appears as a “Choose how you buy” panel with Visitors, Members, and Wholesale prices.
- Switch: Show “Price by role” table on product pages in Settings > Product page display.
- The table only appears when at least two roles see different prices for the product.
Feature 16: “My pricing” page. Each logged-in customer can open My account > My pricing and see every special offer they have, which products it covers, and any quantity deals. The demo page is titled “Your special pricing” and lists Offer, Applies to, Discount, and Until. Trade customers can check their discounts themselves, which saves you emails and phone calls.
Features 17 and 18: Rule simulator and Role price matrix
↑ Back to topFeature 17: Rule simulator (try before you go live). Pick a product and a type of customer and see exactly what price they would pay, and which rules made it so. You do not need to log out or switch browsers, and nothing on the live store is saved or changed.
Useful when: you have just set up a new deal and want to be sure it works, or a customer says “my price looks wrong” and you want to check quickly.
- Open Role pricing > Rule simulator.
- Choose a Product and a Role (for example Guest (not logged in)). Optionally choose a Specific customer, which overrides the role so per-customer rules apply, and set a Quantity.
- Click Simulate.
- Read the result: the price, the discount, the badge, and a step-by-step trace of which rules fired and why the rest were skipped.
Feature 18: Role price matrix. A big table of your products with the price each customer type pays, all on one screen. It also tells you when a price is hidden from someone.
Useful when: you want a quick overview of your whole price list, or need to double-check nothing has been missed.
- Open Role pricing > Role price matrix.
- Each row is a product and each column is a user role. The Base price column is what a shopper with no role rule pays, and the percentages are measured against it.
- Cells highlighted in green are discounted below the base price by an active rule. The rule number is shown under the price.
- Products with role-based pricing are flagged with a highlighted row and a badge.
- Use the search box, the category list and the 20 / page list, then click Filter.
Feature 19: Analytics
↑ Back to topSee how your deals are doing: how much customers have saved in the last 30 days, which rules are used the most, how many orders each one has been used on, and a day-by-day view.
Useful when: you want to know which offers are actually working, and which ones you could drop.
Where to find it: Role pricing > Analytics.
- Four headline numbers: Active rules, Scheduled rules, Discounted order lines (30 days) and Customer savings (30 days).
- Top performing rules: a table of rules with the number of orders each was used on. Use it to decide which rules to keep, retire, or replicate.
How savings are counted. Savings are counted per discounted order line and recorded when an order reaches Completed. An order that is still processing is not in the savings figures yet. The “Orders used on” column counts whole orders from the moment they are placed, so the two figures will not match.
Feature 20: Import and export
↑ Back to topDownload all your rules as a backup file and load them back later, or onto a different website. When moving to another site, the plugin finds the matching products and customers there. Anything it cannot find is listed, and that rule is kept switched off until you have checked it.
Useful when: you are moving from a test site to your live site, you run more than one shop, or you want a safety copy before making big changes.
Where to find it: WooCommerce > Settings > Role pricing > Import / Export.
To back up your rules
- Open the Import / Export section.
- Use the export option to download your rules as a file.
- Keep the file somewhere safe.
To bring rules in
- Open Import / Export on the site that should receive the rules.
- Choose your backup file and import it.
- Read the list of anything that could not be matched. Those rules stay switched off.
- Check each of those rules, fix the products or customers, then turn them on.
Tip: after importing, run a few checks in the Rule simulator before you rely on the new rules.
Features 21 and 22: Works with your setup, and safe checkout
↑ Back to topFeature 21: Works with the tools you already use. The plugin fits into most shops without extra work. It works with:
- Simple products, and products with options such as size and colour.
- Both the classic and the newer WooCommerce cart and checkout pages.
- Page builders such as Elementor, with a ready-made widget and two shortcodes you can paste anywhere.
- Subscriptions, where renewals keep the price the customer signed up at.
- Add-ons such as gift wrapping, which keep their own price on top of the discount.
Useful when: you do not want to rebuild your shop just to add special pricing. There is nothing extra to switch on for these.
Feature 22: Safe checkout. The shop double-checks prices at checkout. If a deal runs out or changes while someone is checking out, they are shown the new total before paying, so nobody is charged more than they expected.
Useful when: you run limited deals such as “first 50 orders” and want to avoid unhappy customers or refund requests. This works automatically, with no setting to configure.
Settings reference
↑ Back to topGlobal options live under WooCommerce > Settings > Role pricing > Settings. Click Save Changes after editing.
| Panel | Setting | What it does |
|---|---|---|
| Price visibility | Hide prices from these user roles | Roles (and Guest) that see a message instead of a price |
| Price visibility | Message shown when a guest cannot see prices | The text shown in place of the price |
| Quote requests | Let guests request a quote when prices are hidden | Turns the quote form on or off |
| Quote requests | Quote button label | Button text (default “Request a quote”) |
| Quote requests | Quote thank-you message | Shown after a request is sent |
| Quote requests | Send quote notifications to | Email address for requests; blank uses the site admin email |
| Product page display | Live price updates | Whether the price changes as the quantity changes |
| Product page display | Crossed-out regular price, pricing badges, hover explanation | Show or hide each label |
| Product page display | Show “Price by role” table on product pages | Shows what each customer type pays |
