View Product Page

General settings

The plugin allows you to dynamically update product prices according to the role of the user who is going to purchase.

You can either set a global rule, which applies globally to groups of products in your store, or it can be specifically created for a single item in the shop.
Before describing how to create a new rule in both cases, you should focus on some essential elements concerning plugin behavior:

  • Each rule that you have created and configured will be applied to the “Regular price” or to the “sale price” (if set on the product) depending on the option settings in YITH -> Role Based Prices -> General settings.
General settings
  • More than one price rule can be applied to the same product, at the condition that all of them have been specified either in:
    • The “Price Rules” section in the plugin options panel (so they are global rules)
    • The single product page (so they are product rules).

Role Based Prices Transient

Under “General Settings” you will also find the option to use a tool to clear the plugin transients cache as you can see in the image above.

YITH WooCommerce Role Based Transients API allows developers to store information in your WordPress database with an expiration time. This helps speed up your site and keeps your server loading time down, using this option you can remove the transients cache.

Role Based Prices doesn’t allow the creation of new roles. It only manages the ones already available. However, you can create new roles with the use of Members free plugin.

User settings

In the User settings, you can choose which price to show for each user role.

User settings

For each user role available (and guest users as well), you can decide to show:

  • regular price
  • on-sale price (if available)
  • role-based price (if available)

You can customize the text to show for each of these prices, in the Label settings.

Label settings

Add to cart

If you disable the Add to cart option, you will activate a ‘catalog mode’ on every product in your shop.

We use the ‘Administrator’ role as an example.

Disable options

If you decide to show no prices for the product (and disable all options), the plugin will automatically show an alternative text on the product.

Show alternative text to users

You can set this alternative text from the “Label settings” tab.

  • Alternative text to show to users: This text is shown to users instead of the price if all prices (regular, on sale and role-based price) are hidden to a specific user role.
  • Show in: Choose where the text will be displayed on the single product page.
  • Alternative text color: Choose the color of the text.

Frontend text view

Show price incl tax

Decide to show prices with tax included or excluded. You can add a suffix by defining a text to show after the price.

Show prices tax included or excluded

You can set this text from “Label settings”.

Please note, this option does not allow you to exclude or include taxes for certain user roles. The plugin only manages the visual part, so you can choose to show or hide the taxes on prices for certain roles. Taxes are managed globally from WooCommerce > Settings > Tax.

Discount or markup

With Show total discount/markup enabled, you can show the total discount/markup users with a specific role will get on the product.

Total discount/markup settings

You can enter a custom text in the options available in Label settings by using the related placeholders ({ywcrbp_total_markup} and {ywcrbp_total_discount}).

Show price for a different user role

By enabling Show price for a different user role, you can encourage users to get a different role to take advantage of special prices.

To show them what price they would pay if they had another role type, you can enter a text in the option Their price in the “Label settings” tab.

Price of a different user role (text)

For example: If you become Supplier you’ll be able to buy at this price $10.00

frontend text change user role (1)

Create a new global rule

All global rules have to be created in YITH > Role Based Prices > Price rules.

In order to add a new rule, click on “Add new role based price”.

Add new role-based price

To configure your rules assign a value to each of the following options:

Add new role-based price options
  • “Apply rule to”: user role to which you want to assign the current rule.
  • “Rule Type”: Choose where the rule will be applied or not:
    • all products
    • Product category
    • Exclude product category
    • Product tag
    • Exclude product tag
  • “Discount or markup”: this option allows you to select the type of change you want to apply to the price. You can choose between “discount” or “markup” to the current price.
    The value field reflects your selection, shown as a price amount or as a percentage discount/markup on the product price.
  • “Priority”: if more than one rule of the same type (Global, product category or product tag) are created for the same user role, priority allows you to create an order for rules to be applied.
    Example: a priority-1 rule will be applied before a priority-10 rule.
  • “Activate rule”: by default, the rule is created and immediately enabled. Yet, if you uncheck this option, you can disable the rule without having to delete it and enable it only when needed.

In case more than one rule of the same type has been configured for the same user role, they will be sequentially applied according to the priority they’ve been given. Global rules are ignored if at least one product rule has been configured in the product.

If you are not ready to publish the new rule, you can use the “save draft” option.

Create a new product rule

The plugin allows creating custom-tailored price rules for user roles, which are specific to each product of the shop.
The first step to take is to specify what behavior the plugin must acquire on the current product.

  • Use only the rules below: apply on product only the rules available right inside the product, ignoring general rules
  • Override rules created for the same user role: apply on product the general rules, except those that have been overridden right inside the product


Now select the rule type you want to add between discount or markup.

  • name the rule;
  • select user role to which the rule applies;
  • set a value (percent or amount, according to rule type).

In the example shown in the above image, we have applied a 30% discount for all “Customers”.

If there is more than one rule for the same role, they will be sequentially applied according to the priority they have been given. To set priority for your rules, you can sort them by simply dragging and dropping them in the list (rules on top have higher priority).

All plugin features can be applied also to “variable products”.
Each product variation is treated as an individual product, so, what has been described above for simple products goes also for rules on each product variation.


Suppose we have these two products:

  • Product_1 in the category “Poster” and its base price is €20
  • Product_2 in the category “Poster, Photo” and its base price is €40

Suppose we want to create the following rules for the “Admin” role:

  • Rule 1
    • Rule type: “All Product”
    • Discount: 40%
    • Priority: 1
  • Rule 2
    • Rule type: Category “Poster”
    • Discount: 20%
    • Priority: 2
  • Rule 3
    • Rule Type: Category “Photo”
    • Discount: 50%
    • Priority 3

Which is the price shown to admins for Product_1?
The rule that applies, in this case, is Rule 2 (Rule 1 will not apply because there’s a more specific one).
So, 20-(20*20/100) = 16

Which price will be assigned to Product_2 for admins?
This time, Rules 2 and 3 will apply.
40-(40*20/100)= 32 this is the discount given by Rule 2.
32-(32*50/100) = 16 this is the discount they get after Rule 3 applies.

YITH Automatic Role Changer

YITH Automatic Role Changer for WooCommerce allows you to automatically assign a new role to your users or replace the one they had. Just configure the condition that will let them get a new role or switch from one to the other, choosing from the following ones:

  • the user purchases a specific product
  • the order total is within a certain price range
  • the customer’s total spend falls within a certain price range
  • the user purchases products from specific categories or tags.

The integration with YITH Role Based Prices allows you to forget about changing roles manually and automate your marketing strategies: your users will automatically see the updated price if they buy a given product, make a total spend, etc.

To start using both plugins together, all you have to do is to activate both of them from the Plugins page in your WordPress dashboard.

Then, start configuring automatic change rules as explained in detail on this page.

Note: to make the role-based price show correctly, please, make sure that your users have no more than one role assigned. If they happen to have more than one user role at the same time, no role-based prices will be shown.


Configure three custom rules with YITH Role Based Prices plugin.

  1. 10% off for the role New customer
  2. 20% off for the role Returning customer
  3. 50% off for the role Loyal customer
Create rules

Then, create the switch rules from YITH Automatic Role Changer settings panel:

  1. Switch from New customer to Returning customer if the customer’s total spend exceeds £500.
  2. Switch from Returning customer to Loyal customer if the customer’s total spend exceeds €1,000.Automatic role changer rule

If you want to read more about how to configure YITH Automatic Role Changer for WooCommerce, please, refer to the plugin official documentation.

YITH Dynamic Pricing and Discounts

YITH WooCommerce Dynamic Pricing and Discounts is a plugin conceived to create advantageous purchase conditions for your users. In an easy and intuitive way, you can configure ad hoc discount rules for your users and create convenient offers that will highly increase the sales of your products.

The integration between these two plugins allows calculating discounted prices based on role-based ones automatically rather than on WooCommerce prices.

After installing and activating both plugins, you only need to create your own role-based price rules with YITH Role Based Prices and the discount rules with YITH Dynamic Pricing and Discounts.

Role-based discounted price

For further details about YITH Dynamic Pricing and Discounts settings, please refer to the official documentation.


YITH Multi Vendor

With YITH Multi Vendor you can turn your e-commerce store into a marketplace (a multi-vendor platform) like Amazon or Etsy. Turn your e-commerce store into a marketplace (a multi-vendor platform) and earn commissions on orders generated by your vendors.

When used with YITH Role Based Prices, also your vendors will be able to create price rules by user role that will be applied only to their own products.

To enable this integration, just make sure that the two plugins are installed and activated. Then, enable the Role Based Prices module from YITH > Multi Vendor > Modules.


Now, your vendors will be able to see a dedicated menu from where they can create their own price rules.

Role based rules for vendors

For their own products, vendors can also override the price-by-role rules from the product settings.

Role based in product edit page

All general rules created by the site’s global administrator won’t cause any effect on products related to a vendor.

For further details about the plugin YITH WooCommerce Multi Vendor, please, refer to the official plugin documentation.

YITH Product Add-ons

YITH WooCommerce Product Add-ons allows you to configure additional product options that will be added to one or more products in your shop. For each option, it’s possible to choose a title, an image and a price, which will add up to the basic ones the product has.

You’ll have at your disposal many different types of add-ons, conditional logic, etc.

The integration between this plugin and YITH WooCommerce Role Based Prices allows changing the base product price according to the role of your users while keeping the add-on prices unchanged for all users.

All you have to do is to activate both plugins from the Plugins menu and then start configuring your role-based prices rules from this page, which apply to the product’s regular price.

After that, you can start configuring your add-ons to let your users have custom options and, if you want to, charge a fee for each selected add-on. Learn more about how to configure the add-ons on this page.

Integration with YITH Product Add-ons

All your users will be able to customize their own products thanks to the add-ons you’ve added to the product page. The product price will be calculated starting from their role-based price. The add-on prices will be the same for every user and will regularly add to the product role-based price.

If you want to learn more about how to properly set up YITH Product Add-ons, please, refer to the plugin official documentation.

YITH Product Bundles

YITH WooCommerce Product Bundles allows you to create bundles of products of your shop. You can assign a fixed price to the bundle or get the price as the sum of the single elements in the bundle with custom discounts.

YITH WooCommerce Role Based Price can be perfectly integrated into YITH Product Bundles and set a different price also on bundle products. 

To start setting dedicated role-based discounts on Bundles, you just have to install and activate both plugins (premium versions) from the menu Plugins.

Everything will go through automatically. Just make sure you set the correct discounts from Role Based settings and they will also apply to the bundle.

This is an example of how the discounts of YITH Role Based Prices and YITH Product Bundles plugin combine on a bundle product, where for the Polo bundled product:

  • $12 is the role based price and
  • $6 is the role-based price with the bundle discount.

Read more about YITH Product Bundles in the official plugin documentation.