Complete guide to RewardsWP settings

Prasant Rai

Written by Prasant Rai
Updated

On this page

Would you like to know what each RewardsWP setting does before you change it? The RewardsWP settings page controls your points, referrals, VIP tiers, rewards widget, spam protection, and store integrations.

This guide walks through each settings tab and explains what its options do.

  • Saving Your RewardsWP Settings
  • General
    • License key
    • General settings
    • Spam protection
    • Points
    • Referrals

      Before you get started, make sure RewardsWP is installed and activated on your site.

      Saving Your RewardsWP Settings

      To open the settings, go to RewardsWP » Settings in your WordPress admin. The settings screen has a tab for each settings group. Each tab is divided into sections.

      Settings save from a save bar, which appears when you have unsaved changes. Its Save Changes button saves them. Cmd+S on a Mac or Ctrl+S on Windows also saves them.

      If you try to leave the page with unsaved changes, RewardsWP warns you first.

      Settings drawers, such as the one for a way to earn, close with a Done button. Then save your changes from the save bar.

      Next, the General tab covers your license, general settings, and spam protection.

      General

      The General tab contains two sections that establish the foundation of your RewardsWP setup. The first controls licensing and feature availability.

      The second, General settings, defines core rules that affect how customers take part in your programs. It also holds the spam protection setting, which helps keep bots out of the rewards widget.

      License key

      Your RewardsWP license key determines which features are available across the plugin. When a valid license is active, Pro functionality is unlocked and automatic updates are enabled. This gives you access to advanced reward types, email notifications, and ongoing improvements.

      Different license tiers control which settings and reward options appear throughout the interface. As a result, certain features are only visible when the appropriate license level is active. This keeps the settings experience focused and relevant to your plan.

      License key

      License status indicators provide immediate feedback. They clearly show whether your license is valid, expired, invalid, or deactivated. This shows you at a glance whether any features are restricted.

      Next, the General settings section explains how RewardsWP behaves for your customers.

      General settings

      General settings define how RewardsWP behaves at a foundational level. These options influence tracking behavior, URL structure, and who can participate in your programs.

      Here’s how to set them up:

      • Currency: In this field, select the currency your store uses for transactions. For example, you might choose “United States Dollar (USD).” This ensures rewards align with your store’s pricing.
      • Referral Slug: The unique identifier used in referral links, such as “share.” A referral link might look like yoursite.com/?share=5ee7bdf.
      • Cookie Expiration: In this field, set the duration for which a referral link remains valid. By default, this is 30 days. A referred friend must make a purchase within 30 days for the advocate to earn a reward.
      • Program participants: Program participants determine who is allowed to take part in the RewardsWP program. You can allow participation from:
        • All customers, including guests and registered users, or
        • Members only, limiting participation to customers with WordPress accounts
        RewardsWP general settings

        These settings form the foundation of your referral program. It’s essential to set them up accurately.

        Next, the Spam protection section explains how RewardsWP helps keep bots out of the rewards widget.

        Spam protection

        On the General tab, find the Spam Protection setting after Program Participants. It helps keep bots out of the rewards widget forms that let a visitor in or claim a gift.

        These are the sign-up, sign-in, and friend gift forms. Protecting the friend gift form is available on the Basic, Plus, and Pro plans.

        Spam protection doesn’t check product reviews. Reviews go through your store’s own review moderation.

        For more on reviews, read Earning points from product reviews.

        The rewards widget signs customers up itself. A CAPTCHA plugin on your store can’t protect it. That’s why RewardsWP has its own spam protection, with two choices:

        • Honeypot: the default. It’s built in and needs no setup. It guards the sign-up form, and the friend gift form on the Basic, Plus, and Pro plans. It doesn’t run on the sign-in form, because browser autofill can trip it.
        • Cloudflare Turnstile: a free check from Cloudflare. It guards the sign-up and sign-in forms, and the friend gift form on the Basic, Plus, and Pro plans. It needs a free Cloudflare account, a site key, and a secret key.

        Cloudflare Turnstile runs invisibly, unless Cloudflare asks the visitor to interact with it.

        If you’re not sure which to pick, start with Honeypot, because it needs no setup.

        If bots still join through the rewards widget, switch to Cloudflare Turnstile. It also guards the sign-in form.

        Setting up Cloudflare Turnstile

        First, you’ll get your keys from Cloudflare. In your Cloudflare dashboard, add a Turnstile widget for your store’s domain. Then copy its site key and its secret key.

        Cloudflare’s Turnstile documentation explains how to add a widget.

        Next, back in WordPress, go to RewardsWP » Settings. On the General tab, find the Spam Protection section and choose Cloudflare Turnstile.

        Then paste your keys into the Site key and Secret key fields. These fields show once you choose Cloudflare Turnstile.

        To turn Turnstile on, click Save Changes in the save bar.

        Checking your Turnstile keys

        The settings screen checks both keys. If Cloudflare doesn’t accept a key, the issues panel on the settings screen lists it.

        To open the panel, click the issues button on the settings screen.

        To fix a key, click the link under the issue, such as Fix the secret key.

        Then copy the key again from your Cloudflare dashboard and paste it in.

        Here’s what the rewards widget does while a key needs attention:

        • If you choose Cloudflare Turnstile but leave a key empty, the rewards widget uses Honeypot.
        • If Cloudflare can’t be reached, or says the secret key is wrong, visitors get through without the check. The issues panel tells you when this happens.

        For more ways RewardsWP keeps your program safe, read Referral fraud prevention.

        Next, the Points tab sets up how customers earn and redeem points.

        Points

        The Points tab manages your loyalty program, allowing customers to earn and redeem points through purchases and engagement.

        For complete Points program documentation, see the Complete Guide to RewardsWP Points.

        Next, the Referrals tab controls the referral program from start to finish.

        Referrals

        The Referrals tab controls how your refer-a-friend program works from end to end. This includes when the program is active, what rewards are issued, and how advocates share their referral links.

        Referral settings are designed to help you balance generosity, profitability, and ease of sharing, while keeping the experience simple for customers.

        Program status

        Program status acts as the master control for the referral program.

        When the program is Active, RewardsWP generates referral links for advocates, displays sharing options in the rewards widget, and begins tracking referrals. When the program is Inactive, all referral related features are hidden from customers and no new referrals are tracked.

        Importantly, deactivating the program does not delete any existing data. Previously issued rewards, referral history, and advocate links remain safely stored. This makes it easy to pause your program temporarily without losing progress.

        Next, the Referral tracking section controls how RewardsWP identifies and attributes referrals.

        Referral tracking

        The Referral Tracking section controls how RewardsWP identifies and attributes referrals.

        Referral variable

        The referral variable defines the URL parameter used in referral links. This value appears in every referral URL shared by advocates.

        For example, if the referral variable is set to share, referral links will look like:

        https://yourstore.com/?share=ABC123

        This parameter allows RewardsWP to associate visits and purchases with the correct advocate. Because referral links are shared externally and reused over time, keep the referral variable short, clear, and finalized before launch.

        Referral cookie duration

        Referral cookie duration controls how long referral attribution remains active after a visitor clicks a referral link. When someone clicks a referral link, RewardsWP stores a cookie in their browser containing the advocate’s identifier. As long as the cookie is valid, any qualifying purchase will credit the advocate, even if the purchase happens days later.

        Next, the Referral Rewards section defines what each side of a referral receives.

        Referral rewards

        The Referral Rewards section defines what happens when a referral successfully converts. RewardsWP supports two sided rewards, meaning you can reward both the advocate who shared the referral and the friend who placed their first order.

        Each side is set up on its own, giving you flexibility to design rewards that balance generosity and profitability.

        Advocate reward

        The Advocate Reward is issued to the existing customer who successfully refers a friend.

        When you click Add Reward under Advocate Reward, you can choose from the following reward types:

        • Amount discount: Issues a fixed amount coupon, such as ten dollars off.
        • Percentage off: Issues a percentage based discount, such as 20% off.
        • Free shipping: Issues a coupon that removes shipping costs.
        • Points: Awards points directly to the advocate’s points balance. This option is available when the Points program is enabled.

        Advocate rewards are issued each time a qualifying referral converts, ensuring advocates are rewarded consistently for continued sharing.

        Friend reward

        The Friend Reward is issued to the new customer on their first order after arriving through a referral link. When you click Add Reward under Friend Reward, you can choose from the following reward types:

        • Amount discount: Issues a fixed amount coupon for the friend’s first order.
        • Percentage off: Issues a percentage based discount.
        • Free shipping: Issues a free shipping coupon.

        Each friend reward type is a coupon. The friend gets a benefit on their first purchase.

        Next, see how the advocate and friend rewards work together during a referral.

        How referral rewards work together

        Once both rewards are set up, RewardsWP handles the entire referral flow automatically:

        1. An advocate shares their referral link.
        2. A friend clicks the link and places their first order.
        3. The friend receives their reward on the qualifying order.
        4. The advocate receives their reward after the referral is confirmed.

        Each referral generates new rewards. All reward issuance is tracked internally. There are no duplicate or missed rewards.

        Next, the VIP tab covers how customers move up through tiers.

        VIP

        The VIP tab sets up tiers that customers climb as they spend, earn points, or refer friends. The tab has three sections:

        For how the program fits together, read Understanding the VIP Program.

        Next, the Rewards widget section covers how the widget looks and how customers share their referral links.

        Rewards widget

        The rewards widget is what your customers use to share their referral links and track rewards. It’s fully customizable to match your brand and enhance the user experience. As you change the widget’s design and settings, preview the updates in real time before you save.

        RewardsWP Rewards widget
        • Brand Color: In this field, choose a color that aligns with your branding. This will be used throughout the widget’s design.
        • Rewards Launcher Display: Customize how the launcher appears on your site. Options include:
          • Icon with Text
          • Text Only
          • Icon Only

          You can also edit the launcher text (e.g., “Earn Rewards”) and choose its position on the screen for optimal visibility.

          • Sharing Options: Allow customers to share their referral links directly from the widget. Supported methods include:
            • Facebook: Customers can share their links. Facebook requires users to write their own messages when posting.
            • Email: Customize the subject and message for referral emails. Placeholders like {site_name} and {referral_link} personalize each message.

            Next, the Integrations section shows how RewardsWP connects to your store.

            Integrations

            RewardsWP supports WooCommerce and Easy Digital Downloads, ensuring compatibility with the most popular eCommerce platforms.

            RewardsWP integrations
            • If WooCommerce or Easy Digital Downloads isn’t installed, you’ll see a message prompting you to install and activate the respective plugin. See How to Install a WordPress Plugin for a step-by-step guide.
            • Once installed and activated, RewardsWP automatically enables the integration. For example, you’ll see a confirmation message like “The WooCommerce integration has been automatically enabled.”

            These integrations ensure seamless tracking of referrals and reward application during the checkout process.


            That’s it! You know what each RewardsWP settings tab does, including how to protect the rewards widget from bots. Next, to set up how customers earn and spend points, read the Complete guide to RewardsWP Points.

Still stuck? Submit a ticket and the team that builds it will help.

RewardsWP

Turn One‑Time Buyers Into Lifelong Customers

Points, rewards, referrals and VIP tiers, all in one widget your customers open from any page of your store.