Home › AffiliateWP › WP Referral Clarity
Add-on for AffiliateWP

WP Referral Clarity

Your affiliates can't see their pending referrals in AffiliateWP. Referral Clarity shows them the 20 most recent and why each one is still pending.

Needs
AffiliateWP (tested with 2.36.1)
Tested up to
WordPress 7.1
Version
1.1.4 Changelog
Updated
13 October 2026
Licence
1, 3, 5 or unlimited sites per key

Read the setup guide

What it does

WP Referral Clarity is an add-on for AffiliateWP that explains every referral in plain language, to you and to your affiliates. AffiliateWP leaves pending referrals out of the Affiliate Area, so a sale an affiliate drove looks like it never happened and the question comes to you: where's my commission? Referral Clarity lists their 20 most recent pending referrals at the top of the Referrals tab, each with your plain-language reason for holding it.

Out of the box there is no date. Add a date rule to the Pending row in Status Explanations and every pending referral gets "Expected to clear around" and a date. You also get a charted dashboard, saved and scheduled reports, and flags for suspicious patterns. It only reads AffiliateWP's data and never changes it.

A dashboard you can read at a glance

Revenue, referrals, conversion rate and flagged anomalies at the top, a 30-day revenue chart, and your top affiliates ranked by what they earned.

Every referral status explained in plain language

Affiliates see why each pending referral is still pending, right on their Referrals tab. A clearing date shows only once you set a date rule. Admins see the same explanations, so you and the affiliate read the same reason when they ask "where is my commission?"

Segment, save and export any report

Combine filters for status, date range, affiliate, campaign, source and product. Save the view, schedule it as an email digest, or export it to CSV or PDF.

Suspicious patterns flagged for review

Rapid repeat conversions, referrer/referee matches and volume spikes are flagged for a human to review. Nothing is blocked automatically, and AffiliateWP stays the system of record.

Wording you control

Edit the admin and affiliate wording for every status on the Status Explanations screen, no code needed; tagging a referral with a hold reason such as a return window takes a short code snippet (the wprc_pending_referral_context filter).

The problem

AffiliateWP is good at tracking referrals. It is less good at explaining them. In an affiliate’s own dashboard, paid, unpaid and rejected referrals show up, but a referral that is still pending doesn’t appear at all. From where the affiliate sits, a sale they drove has vanished, so they email you to ask where it went.

The admin side has its own version of the gap. You get lists and totals, not reasons, and anything beyond the default reports ends up in a spreadsheet.

What changes for your affiliates

  • A Referral Clarity panel at the top of their Referrals tab shows their approved-but-unpaid total and their 20 most recent pending referrals, each with a plain-language reason and, where you have set a rule, an expected clearing date. It works with LearnDash referrals too, because the panel lists pending referrals whichever AffiliateWP integration recorded them, as our guide to selling LearnDash courses with AffiliateWP shows.
  • Their existing referral history gains a “Why” column with the same explanations.
  • If you allow it, they can opt in to a regular email digest of their own referrals and anything still pending.

What changes for you

It needs AffiliateWP installed and active, then installs like any other plugin. Installing an add-on and activating your licence has the steps.

  • A dashboard you can read quickly. Today’s revenue, referrals, conversion rate, pending count, this month against last month, a 30-day revenue chart and your top affiliates by revenue. It reads from a snapshot refreshed every hour by default, so large programmes stay fast. “Refresh now” updates it on demand.
  • Reports you can keep. Combine filters for status, date range, affiliate, campaign, tier, product and referral source. Save the view, share it with other admins, email it daily, weekly or monthly, or export it to CSV or a print-ready PDF page.
  • Flags worth a second look. Three patterns are checked automatically: rapid repeat conversions from one affiliate, a referred customer whose name or email domain matches the affiliate’s own, and a daily volume far above that affiliate’s normal.
  • Your own wording. Every status (pending, unpaid, paid, rejected and forced pending) has admin and affiliate wording you can edit, with extra contexts for holds specific to your store, such as a return window. Tagging a referral with one of those holds needs a short code snippet (the wprc_pending_referral_context filter).

What it doesn’t do

  • It never changes a referral’s status. Approving, rejecting and paying still happen in AffiliateWP.
  • The anomaly checks only flag. They don’t block or reject anything, and AffiliateWP’s own fraud settings keep running as normal.
  • “Export PDF” opens a print-ready page and uses your browser’s Save as PDF. There is no server-generated PDF file.
  • The dashboard is a snapshot, so it can be up to one refresh interval behind. Reports always run live.

Requirements and compatibility

Your site needs

Plugins
AffiliateWP (tested with 2.36.1)
WordPress
6.5 or newer
PHP
8.0 or newer
Multisite
Supported

This release

Version
1.1.4
Updated
13 October 2026
Tested up to
WordPress 7.1
Known conflicts
None known
Changelog

Version 1.1.4

1.1.4
* Fix: an affiliate with no paid, unpaid or rejected referrals no longer sees an empty "Why" column beside "You have not made any referrals yet." The column appears once the table has rows.
* Fix: the default return-window wording no longer says the referral "will automatically become payable", which contradicted "Waiting for the store to approve it." once the window had passed. It now says the store approves it for payout once the window has closed. Updating replaces the old wording only if you never edited it.

1.1.3
* Fix: activating or reactivating the plugin no longer logs "Multiple primary key defined" database errors. Existing data is kept.
* The plugin description no longer says it replaces AffiliateWP's screens. Tested up to WordPress 7.1.

1.1.2
* Affiliates now see when a held referral should clear. If your store tags a pending referral with a hold reason that has a date rule (the return window, out of the box), the affiliate panel shows that reason's wording and "Expected to clear around" with the date.
* A referral held for a reason with no date rule now says "Held by the store. No clearing date has been set yet." instead of showing nothing. Untagged pending referrals look the same as before.
* A clearing date that has already passed is no longer shown as expected. The panel says "Past the store's usual hold period. Waiting for the store to approve it."
* Setting your own hold period (for example 14 days) now works with a filter that checks for the pending status. The FAQ shows how to tag a hold reason and set the period.

1.1.1
* The license server address and product are now fixed in the plugin and can no longer be changed from wp-config.php.

1.1.0
* Multisite: one license covers the whole network, and each subsite running the plugin counts
as one site against the license's site limit (1, 3, 5, or unlimited). The license is stored
network-wide and only a network (super) admin can activate or deactivate it.
* Adding a subsite, or activating the plugin on one, takes an activation automatically; deactivating
the plugin on a subsite or deleting the subsite frees it again. Updates are only offered while
every subsite running the plugin is activated.

It runs alongside AffiliateWP and never changes its files, so you can keep updating AffiliateWP as usual.

How it compares

  AffiliateWP on its own With WP Referral Clarity
Affiliates see pending referrals No Yes, with a reason. A date once you set a date rule
Explanation for each referral Status label only Plain-language, editable, for admins and affiliates
Saved and scheduled reports No Save, share, email daily, weekly or monthly
Filters Basic filters and search on the Referrals screen Status, date, affiliate, campaign, tier, product and referral source, combined
Review flags for odd patterns No Three patterns, flag-only
Changes your referral data N/A Never. Read-only.

Full comparison: AffiliateWP reports vs WP Referral Clarity

Who it's for, and who it isn't

Buy this if

You run an affiliate program on AffiliateWP and spend time explaining referral statuses or building reports by hand.

Don't buy this if

You don't use AffiliateWP, or you only need the default referral list.

Guides and comparisons

Frequently asked questions

Does this replace AffiliateWP?

No. It is an add-on and needs AffiliateWP installed and active. Without AffiliateWP it shows an admin notice and does nothing else. AffiliateWP stays the system of record for referrals, affiliates and payouts.

Does it change my referral data?

No. It never approves, rejects, pays or edits a referral; that all stays in AffiliateWP. It reads AffiliateWP's data and writes only to its own tables (your wording, saved reports, dashboard snapshots and review flags), plus each affiliate's choice about the weekly email.

Will my affiliates see when a pending referral should clear?

Yes, but only when a date rule applies: either on the Pending row in Status Explanations, which dates every pending referral, or on a hold reason such as return_window that you tag referrals with in code. A plain install shows the reason and no date. The date is the referral date plus your hold period, 30 days unless you change it with the wprc_status_resolution_days filter. Typing a number into the rule does not change it. On our test store a referral dated 9 October showed 8 November. Once that date passes, the date goes away and the panel says the referral is past the store's usual hold period and waiting for you to approve it. Holds with no rule, such as a manual review, say no clearing date has been set yet. The date is also in the REST endpoint. Only the affiliate it belongs to and store admins can read it; another affiliate gets an error.

Does it work with AffiliateWP's Affiliate Portal add-on?

No promise yet, because it is not tested yet. The panel and the Why column attach to AffiliateWP's standard Affiliate Area, and that is where we tested them, on AffiliateWP 2.36.1. Affiliate Portal gives affiliates its own full-screen dashboard, and we have not checked whether the panel appears there. If you use Portal, email support@pluginsprout.com before you buy.

Will it slow my site down?

No heavy work happens on page load. The admin dashboard reads a snapshot refreshed every hour by default instead of adding up your whole referral history each time. The affiliate panel runs only on the Referrals tab and fetches at most 20 pending referrals plus the approved total. The review-flag check runs in the background with the snapshot, 500 referrals at a time. On the front end it adds two small stylesheets and one script, about 10 KB before compression.

Do the review flags block or reject referrals?

No. Three checks run: rapid repeat conversions from one affiliate, a referred customer whose name or email domain matches the affiliate's own, and a day's volume far above that affiliate's normal. Each one only adds the referral to a list for a person to review. Marking a flag as reviewed changes the flag, never the referral, and AffiliateWP's own fraud settings keep running as before.

Does every licence get every feature, and can I get a refund?

Yes to both. Every licence has every feature: $79 a year for one site, $129 for three, $159 for five or $199 for unlimited, each with a year of updates and email support. If you don't renew, the plugin keeps working but stops receiving updates. Email support@pluginsprout.com within 14 days of buying, from the address you bought with, and we refund the full amount.

WP Referral Clarity $79 a year, one site