View Product Page

Add a new rule

This plugin allows you to create as many allocation rules as you can use to associate different roles based on different actions.

In order to create a rule, you need to go to YITH > Automatic Role Changer. Now enter a unique name for your rule in the field “Name the rule” and click on Add new rule: Create new rules

You can now customize your rule, choosing from “The user will gain the role” to decide which role will be assigned to the user for the action specified below:

Gain user role

The second option is “Switch role”: the user role will change from one to another based on the action options specified below:

Switch user role

You can choose from one of four options:

Rule conditions

  • User purchases a specific product
  • Order total is within the following price range
  • Customer’s total spend falls within the following price range
  • User purchases products from specific categories or tags

Force apply rules

With the option “Force apply rules”, you can search already existing orders (with no rules applied), and apply the current rules with a bulk action.

NOTE: This procedure cannot be undone, use it with caution.

Force rule

Set the dates you want and click on “Force apply rules”; you will receive a warning asking you if you are sure you want to apply the change.

Purchasing a specific product

If you want to assign a role with the purchase of a specific product, you can select your product or the product variation in the section “Choose a product”.Select product

Right underneath, you will get to select a date range, selecting both the start date and the end date.

Date range

N.B. If you set up the expiration date, purchasing said product will no longer assign roles after that day and all of the obtained roles will be removed.

For instance, you might create an allocation rule for a role that’s only available during December (to create a Christmas discount, using YITH Role Based Prices) which expires on the last day of the month.

After this day, the role will be removed from all of the customers who obtained it and that will be no longer possible to obtain using this rule.

Ultimately, you can state if a customer already has a specific role, so that the role won’t be assigned in their case. To do so, choose the role a customer already has from “Do not apply this rule to users with the following role(s)”:

Do not apply rule

Price range

You can assign a role based on price, through 2 options:

  • Order total
  • Total spend by customer

For both options, you can set a minimum, maximum or a specific range of money spent. If you select one of these options, it will display a new section where you can select the price range and date range:

Order total rule option

Purchasing a product from a specific category or tag

In case you want to extend the assignment of a specific role to a whole category or tag, by selecting the third option, you will see the “Select a taxonomy” section.

Specific category or tag

So, by inserting the initials of a specific category or tag, you will be able to select it from the displayed list:

Select category

Expiration settings and date range

Expiration settings

For every rule that you create, you can choose whether the role is assigned forever or if it can be granted only for a limited time.

So, for example, if your customer gets the GOLD role because he’s purchased product X, he can get this role only for 30 days. After that time, when the role ‘expires’, the previous role will be restored.

To set an expiration for the new role, scroll down in the rule settings. You’ll find a field called Set duration for the roles (days). Enter any value in days.

User role expiration

When this time has passed, the previous role will be restored.

So, if a customer switches from Customer role to Gold and the Gold role is limited to 30 days, after 30 days, the role Gold will be removed and the Customer role will be restored.

Set a date range

For every rule, you can also set an application time range, so the rule is applied only if the conditions are fulfilled during that time range. Before or after the dates that you enter there, the rule will be disabled.

Set a date range

Easily spot the orders that assigned specific roles

In the “Orders” page of your WooCommerce store, each order with a role assigned will have a custom icon shaped like a crown:

Role icon on Orders page

The order page itself will display a note including the obtained role:

Role note in order details

Customer view

The customer will be able to see the role gained with the order, in their My Account page. It will be visible after the order gets the status ‘completed’.

Gained role on My Account page

Email notifications

Two emails are added to the default WooCommerce ones:


These two emails will inform customers and admin the moment a role is assigned after a transaction.

Admin email

You have the option to set more than one email address for the admin emails.

Email recipients

How to create the new roles you wish to assign

You are free to assign any role available, after a transaction on your WordPress website, however, the plugin won’t let you create new ones. To do this we recommend using this free plugin: Members.

Once the plugin is installed and activated, you will find the option to create new roles, in the “Members” menu:

Add new role

Now you will be able to select all the allowed actions for users that obtain the role you’ve created:

Custom role

YITH Role Based Prices

YITH Role Based Prices allows you to show different prices based on the role your users have, and offer dedicated discounts or increase the product prices.
Choose all the prices you want to show: Regular price, Sale price, and Role-based price.

The integration with YITH Automatic Role Changer 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 role-based price rules as explained in detail here for global rules and here for product rules.

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 customerprice rules role based prices

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 WooCommerce Role Based Prices, please, refer to the plugin official documentation.