Description
The External Referral Links add-on captures the ?ref= parameter on external WordPress-based sites, storing the affiliate ID or username in a browser cookie and automatically injecting that identifier into menu links and pages that point back to the main AffiliateWP site. Recommended for multi-domain operations where the institutional site is separate from the store, it allows affiliates to promote external marketing pages without losing referral credit when the visitor reaches checkout.
Key Features
- Cross-site referral cookie: stores the affiliate identifier in the browser as soon as the visitor arrives at the external domain via a link with ?ref=.
- Automatic injection into internal links: rewrites URLs of menus and pages on the external site that point to the main domain, appending the affiliate ID.
- Support for numeric ID and username: accepts both ?ref=123 and ?ref=joao in the source URL.
- Customizable referral variable: lets you change the parameter name if the affiliate program uses a different string than “ref”.
- Configurable cookie expiration: sets how many days the affiliate identifier is stored in the visitor’s browser on the external site.
Benefits of External Referral Links
- Correct attribution across domains: keeps the referral valid when the visitor navigates on a marketing site before reaching the store.
- More freedom for the affiliate: makes room to promote content pages, blogs, or landing pages hosted outside the main domain.
- Centralized configuration: adjust the variable name and cookie time on dedicated screens, without needing to modify the template.
- Preserved funnel: prevents clicks originating from multi-domain campaigns from losing the link to the corresponding commission.
Who Is It For?
- Businesses that keep the institutional or marketing site separate from the store where AffiliateWP runs.
- Affiliate programs that want to expand promotion channels to external WordPress-based pages.
- WooCommerce stores, Easy Digital Downloads, or membership platforms that rely on traffic coming from secondary domains.
Recommended for affiliate program managers operating in a multi-site architecture who need to ensure that every referral is recorded, even when the visitor passes through external domains before conversion.
Frequently asked questions
Is AffiliateWP External Referral Links GPL-licensed?
Yes. AffiliateWP External Referral Links is distributed under the GPL (GNU General Public License). You may legally use, modify and redistribute it on as many sites as you want.
Can I use AffiliateWP External Referral Links on multiple sites?
Yes. You can install AffiliateWP External Referral Links on as many sites as you want. Only automatic updates through Ultrapack Auto Updater have a limit: from 3 to 80 sites, depending on the plan.
How much does AffiliateWP External Referral Links cost at Ultrapack?
AffiliateWP External Referral Links costs US$2.99 as a single purchase, and it is also included in the subscription plans starting at US$12/mo (VIP I).
Does AffiliateWP External Referral Links include updates?
Yes. The current version of AffiliateWP External Referral Links is 1.2, published at Ultrapack on Nov 4, 2021. Subscribers update straight from the WordPress dashboard with UAU (Ultrapack Auto Updater).
Is AffiliateWP External Referral Links scanned before publication?
Yes. Every version of AffiliateWP External Referral Links goes through a malware scan (ClamAV and YARA rules, at UltraHub) before it is published.
What are the requirements for the plugin AffiliateWP External Referral Links?
Requires WordPress 5.2 or higher and PHP 5.6 or higher. Tested up to WordPress 5.7.
What changed in this version
Version 1.2
- New: Requires WordPress 5.2 minimum
Version 1.1.2
- Fixed: Fix Pantheon-specific cookie prefix delimiter
Version 1.1.1
- Improved: Add Pantheon platform detection for cookie naming
- Fixed: Remove AffiliateWP requirement
Version 1.1
- New: Enforce minimum dependency requirements checking
- New: Requires PHP 5.6 minimum
- New: Requires WordPress 5.0 minimum
- New: Requires AffiliateWP 2.6 minimum
- Improved: Use tracking cookie name getter in AffiliateWP 2.7.1
- Improved: Allow language translations to be handled by WordPress.org
- Fixed: Remove the deprecated screen_icon call from the admin template
Version 1.0.2
- Fix: Referral variable of "join" conflicted with jquery.cookie script
Release notes published by the developer.
How to install
Automatic updates: this item is updated by the Ultrapack Auto Updater. With it installed, the new version shows up in your dashboard like any other WordPress update (how to set it up).
This item is an add-on for the AffiliateWP WordPress Plugin plugin. Installed on its own it throws no error, but it does not work either.
- Install and activate the AffiliateWP WordPress Plugin plugin before this one.
- Download the file
affiliatewp-external-referral-links.zip. - In the WordPress dashboard, go to Plugins > Add New > Upload Plugin.
- Select the file
affiliatewp-external-referral-links.zip, click Install Now and then Activate.
Requirements: Requires WordPress 5.2 or higher and PHP 5.6 or higher. Tested up to WordPress 5.7.
- Both stay active at the same time. Deactivating the AffiliateWP WordPress Plugin plugin turns this add-on off with it.
- An add-on settings usually show up inside the main plugin screens, not in a menu of their own. If you find nothing new in the dashboard after activating, look there before opening a ticket.
Stuck on a step? Open a ticket telling us which one you stopped at.

UAU Ready