Documentation

Custom User Restrictions for Loyalty Program

Disable Points for Specific User Role

You can disable points for specific user roles by adding below code to functions.php:

How to enable a referral link for users with active Subscription

READ FIRST: This code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way to access it is by editing functions.php...

Import or migrate points from WooCommerce Points & Rewards

Importing points from WooCommerce Points & Rewards is easy via a dedicated tool. To import points:

Automatically Apply Points at Checkout

If you have Points to Currency Conversion turned on, you might want to automatically apply all available points at checkout. To do this, insert the following JavaScript snippet into your website header or footer. The script works both with block-based checkout and standard checkout.

Disable Points for Specific Products

You can disable points earning for specific products using the wpgens_loyalty_disable_product_points filter: This filter allows you to: The filter receives two parameters: Return true to disable points for the product, false to allow points.

Integrate Klaviyo with Points & Rewards for WooCommerce

If you use Klaviyo for your email marketing, the Points & Rewards plugin makes it easy to sync loyalty data so you can personalize your campaigns based on points activity. With this integration, you can: Klaviyo Integration Setup To enable the integration: Once connected, the plugin will begin syncing loyalty data to Klaviyo in real-time....

Conditional Coupon Rules

While basic redemption actions work well for general use, sometimes you want tighter control over how rewards are used. This guide walks you through setting up an advanced percentage-based reward with optional restrictions and logic – perfect for stores with specific product, category, or usage conditions. Example Setup: “10% Off Any Product” Reward We’ll configure...

Adding Custom Actions to Award or Deduct Points

With the WPGens Points and Rewards for WooCommerce plugin, you can go beyond the default earning rules and award or deduct points based on custom actions performed by your users. This is useful when you want to reward customer engagement outside the usual order flow – such as completing a quiz, interacting on social media,...

Developers – Action Hooks and Filters

= Filter Hooks =

Filter Action List – Advanced Customization and Integration

Developer Documentation – WPGens Points and Rewards Plugin For advanced customization and integration, the Points and Rewards plugin provides full support for template overrides, hooks, and filters. This section is intended for developers who want to extend or modify plugin behavior beyond the standard settings available in the admin dashboard. Template Overrides You can override...

How to send Referral Codes to Klaviyo

READ FIRST: This code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way to access it is by editing functions.php...

Add referral indication to the admin order email

READ FIRST: This code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way to access it is by editing functions.php...

Add Referral Information to Admin Order Notification Email

READ FIRST: This code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way to access it is by editing...

Stop coupon creation and email sending

READ FIRST: This code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way to access it is by editing functions.php...

How to disable a referral link for specific users

READ FIRST: This code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way to access it is by editing functions.php...

Change Refer a friend tab title on My Account page

READ FIRST: This code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way to access it is by editing functions.php...

Grant points to the referrer based on a fixed percentage of the amount spent by their friend (Points & Rewards plugin)

READ FIRST: This code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way to access it is by editing functions.php...

How to hide/show RAF product tab for specific product category?

If you want to hide the Refer a Friend product tab from a specific category of products, you can use the code below – just change “clothing” to your category slug. That way, the Refer a Friend product tab won’t be shown for that category of products. But if you want to hide it from...

Additional security: Check unique user meta

READ FIRST: This code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way to access it is by editing functions.php...

Show a custom message at the checkout when user has unused coupons

READ FIRST: This code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way to access it is by editing functions.php...

Make referral links work for a specific product or category of products

READ FIRST: Code is updated for plugin version 2.0! Also, this code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way...

How to enable a referral link for a specific user role only

READ FIRST: This code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way to access it is by editing functions.php...

Limit the maximum number of coupons/referrals a user can earn

READ FIRST: This code works on the 2.0+ version of a plugin. Also, this code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down...

Hide the referral link for customers without an order

You can hide the referral link for customers without any order by navigating to WooCommerce -> Refer a Friend -> General settings.

Automatically apply coupons for users who have referred friends

READ FIRST: This code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way to access it is by editing functions.php...

WooCommerce Points & Rewards, how to reward users with points instead of a coupon?

If you are using the Woocommerce Points and Rewards plugin, you can reward users for referring friends with points instead of a coupon. To do so, go to the Points and Rewards plugin settings and change the number of points under the “Points earned for referring a user”. After that, if you want to stop generating...

WooCommerce Subscription – recurring rewards

READ FIRST: This code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way to access it is by editing functions.php...

How to remove Refer a Friend Tab from My Account page

READ FIRST: This code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way to access it is by editing functions.php...

How to give a free product to a customer who refers a friend?

If you want to give a free product to customers who refer a friend, you must do the following: Check the image below to see an example of such a configuration. Next, under Include products, click to select a product you would like to give for free. After you’re done with that, navigate to Email...

Display a custom message to customers coming from a referral link

READ FIRST: This code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way to access it is by editing functions.php...

How to send a coupon on other order status than complete?

READ FIRST: This code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way to access it is by editing functions.php...

Add referral link and sharing options as a lightbox after a successful order

If you want to have a referral link together with sharing icons showing to customers after their successful order, you can do so by following the guide below: 1. Install the free Popup maker plugin for your site.  2. Create a new popup, and for “conditions” set Is endpoint to order-received. As shown in the image below. 3. For content,...

Show Referral link and social icons on the Orders Thank You page

READ FIRST: This code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way to access it is by editing functions.php...

How to edit template files and keep them after plugin update?

Version 2 of the Refer a friend plugin was completely written from scratch and now ships with the easy-to-edit front-end templates. So, if you want to edit HTML markup, or some text on any of the front-facing screens of the plugin, such as the My Account tab, product RAF tab, shortcode look, or even emails that...

How to add user referral code to every order details email?

READ FIRST: This code needs to be added at the end of the functions.php file. If you are familiar with editing functions.php, feel free to continue reading. If you haven’t done this before, adding this code in the wrong place might bring the site down and the only way to access it is by editing functions.php...

Connecting referral links to MailChimp

If you want to include the users’ referral codes in the mailing list that you are sending via MailChimp, or if you just want to send a mass email to all registered users telling them about the new referral program, follow the steps below: IMPORTANT: If you only see the First and Last names, make...