Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To create a documented refer-a-friend program in WordPress, your site needs WooCommerce and the WooCommerce Affiliate and Referral extension. You enable customer referrals, define a friend discount and referrer store-credit reward, choose where customers invite friends, set order-status approval, and test the complete journey before launch. An affiliate program is a different workflow: approved partners share links or codes and earn commissions.

Choose the right program first

A customer referral program encourages existing buyers to recommend your store to friends. The documented WooCommerce workflow can give the friend a checkout discount and award the referring customer store credit that can be converted into a coupon.

An affiliate program recruits approved partners who promote products with referral links or codes and earn a commission on qualifying orders. WooCommerce documents these as separate program types, even though one extension can support both. Do not configure affiliate commissions when what you actually want is a customer-to-customer reward.

What you need before installation

  • A WordPress site running WooCommerce.
  • A current version of the relevant WooCommerce extension. Its documented minimums are WooCommerce 4.0+, WordPress 5.0+, and PHP 7.0+; verify present-day compatibility before installing because requirements can change. See the Affiliate and Referral for WooCommerce Documentation.
  • Access to WordPress administrator settings, your live theme, caching layer, security tools and script settings for testing.
  • A clear reward budget, approval policy and terms covering self-referrals and attribution.

Set up a customer refer-a-friend program

  1. Enable the feature. In WordPress, open WooCommerce > Affiliate & Referral > Customer Referral > Settings and enable the customer referral system. The documented workflow is described in WooCommerce’s refer-a-friend setup guide.
  2. Define both rewards. Configure what the invited friend receives at checkout and what the referring customer earns. The documented customer reward is store credit; the customer can convert that credit into a coupon from the referral dashboard. State eligibility, expiry and exclusions in your customer-facing terms.
  3. Choose the invitation location. You can use the storefront’s Refer & Earn button, or enable the shortcode option and place the shortcode on a page that customers can easily find, such as the account area or a post-purchase page.
  4. Set approval timing. Decide whether a referred order is reviewed manually or whether credit is awarded automatically when the order reaches a configured status, such as Processing or Completed. Waiting for a suitable status helps avoid rewarding cancelled or fraudulent orders.
  5. Test before announcing it. Create a real test customer, generate an invitation, complete a referred order and inspect both the referral administration screen and the customer dashboard. The vendor documentation describes this workflow but does not establish independent test results.

Set up an affiliate program instead

  1. Prepare the affiliate dashboard. Activation creates an affiliate dashboard page containing the affiliate-page shortcode. Select that page at WooCommerce > Affiliate & Referral > Advanced Features > General. The getting-started documentation covers this configuration.
  2. Choose registration and approval rules. Optionally select a separate registration page. Decide whether applications require manual verification or become active immediately. The documented setup can also register buyers as affiliates automatically, which should be enabled only if that fits your compliance and fraud controls.
  3. Set the initial commission. Start with one store-wide commission expressed as a percentage or fixed amount. Add product- or category-specific rules only after the basic payout and attribution behavior is clear.
  4. Verify attribution. Have an approved affiliate copy a referral link and place a test order through it. The referral should appear as Pending; an administrator can approve it, or the system can approve it automatically when the order reaches your configured status.
  5. Publish program terms. Explain commission calculation, approval timing, payout method, prohibited self-referrals, refunds and any promotional restrictions before inviting partners.

How referral links are tracked

The documented WooCommerce extension records referral visits in the visitor’s browser with JavaScript. As the official Affiliate and Referral Program FAQ puts it: “Tracking runs in the visitor’s browser with JavaScript, so a strict script blocker, or a cache that strips the referral part of the URL, can stop a visit being recorded.”

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

That means a referral link is not a guarantee that every click will be attributed. Test with the actual theme, cache, CDN, consent banner, security plugin and browser settings used by visitors. In the referral settings, an empty referral-cookie expiration field has a documented default of 30 days; confirm the value in your live installation rather than treating it as an industry standard. The technical flow is explained in How Referral Tracking and Attribution Work.

Where the extension supports it, coupon attribution or a referral-code field at checkout can provide an alternative when link-based tracking is blocked or the customer returns later on another device. These methods still need testing for duplicate credit, refunds and code sharing.

Launch checklist

  • Confirm current compatibility for WordPress, WooCommerce, PHP, the extension and your payment gateway.
  • Test a customer referral from invitation through qualifying order, credit and coupon redemption.
  • Test an affiliate application, approval, link click, pending referral and commission approval.
  • Repeat tests with caching, consent controls, ad/script blockers and mobile browsers enabled.
  • Check what happens when an order is cancelled, refunded, failed or changes status.
  • Publish reward, commission, expiry, eligibility and self-referral rules.
  • Monitor the first live orders in the referral administration screen before relying on automatic approval.

Compare WordPress referral options by operation, not marketing labels

Decision Customer referral Affiliate program
Who promotes you? Existing customers recommending the store to friends Approved affiliates using links or codes
Typical reward Friend discount plus referrer store credit redeemable as a coupon Percentage or fixed commission on qualifying orders
Approval Manual review or automatic credit at a selected order status Affiliate application review, then manual or order-status-based referral approval
Attribution choices Referral link, and where available coupon or checkout code Referral link, affiliate coupon or checkout code where available
Operational risks Cancelled orders, duplicate rewards and blocked tracking Fraud, self-referrals, disputed commissions and payout administration

The documented WooCommerce-oriented options include Affiliate and Referral Program for WooCommerce and Affiliate Program for WooCommerce. The available documentation does not establish an independent feature, pricing or non-WooCommerce comparison, so verify each product’s current features and vendor terms before making a commercial choice. The separate Affiliate Program For WooCommerce Documentation is the relevant reference for that product.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshoot missing referrals

No visit or order appears

Check whether JavaScript was blocked, whether a cache or optimization layer removed the referral parameter, and whether the customer completed the journey in the same browser context. Re-test with caching and script tools temporarily bypassed, then configure exclusions that preserve referral data.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The order is visible but reward is not issued

Inspect the configured qualifying order status and whether the order is still pending manual approval. Also check cancellation, refund and fraud rules before granting credit or commission.

Customers want to share without clicking a link

Offer a supported coupon or checkout referral-code path, and document how attribution is assigned when both a link and a code are present. Test this rule with repeat customers and multiple devices.

Sources

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.