Affireo - Affiliates for WooCommerce Free documentation

Affireo turns your WooCommerce store into an affiliate program. Each affiliate gets a referral link. When a visitor clicks it and later buys, the order is credited to that affiliate and a commission is recorded. You and your affiliates can both follow visits, commissions and payouts.

You control what affiliates earn: a percentage of the order or a fixed amount per order, what the commission is calculated on, a minimum order amount, and a grace period that keeps commissions locked until the refund window has closed. Affiliates apply through a signup form that you build yourself. You approve each application, or let the plugin approve them automatically.

Affiliates use a dashboard on your site to see their earnings, copy their links, choose a payout method and print their payout invoices. You pay them from the Payouts screen with a store credit coupon or by sending the money yourself (manual / offline). The free edition has no time limit, no quota on affiliates and no license key, and it does not connect to any external service.

Affireo is a free plugin from WordPress.org. It needs WooCommerce, so install and activate WooCommerce first.

Affiliates > Overview is the home screen of your affiliate program. It covers the last 30 days and shows:

• Attributed revenue: the value of orders credited to affiliates.
• Commissions: what affiliates earned.
• Visits, Conversions (with the conversion rate) and Active affiliates.
• A Commissions per day chart.
• Top affiliates (30 days): the affiliates with the highest earnings, with their conversions.

When applications are waiting, a notice such as "1 affiliate applications are waiting for review." appears with a Review now button. It opens the affiliate list filtered on pending applications.

Affiliates > All Affiliates lists every affiliate with their Slug, Status, Unpaid balance, Lifetime earnings and the date they Joined.

• Use the status links at the top (All, Pending, Active, Suspended, Rejected) to filter the list, or Search affiliates.
• Hover over an affiliate for quick actions: View / edit, Approve, Reject, Suspend, and Pay now when the affiliate has an unpaid balance.
• To handle several at once, tick their checkboxes, pick Approve, Reject or Suspend in the bulk actions menu and click Apply.

Approving sets the affiliate to active, so their link starts earning commission. Pay now creates a payout for that affiliate right away, whatever the minimum payout is.

Click an affiliate's name (or View / edit) to open their screen. At the top you see their Unpaid balance, Lifetime earnings, Approved referrals and Member since date.

Under Profile & rates you can:

1. Change the Status and add an optional reason. Every change is written to the Activity log.
2. Change the Referral slug used in their links. It must be 3 to 32 lowercase letters, numbers or hyphens. Some words are reserved, and a slug can belong to only one affiliate.
3. Give this affiliate a Custom rate instead of the store default.
4. Set their Payout method. If the affiliate saved payout details in their dashboard, they appear here masked.
5. Click Save affiliate.

Application data shows the answers from their signup form. Recent referrals lists their latest commissions, with links to view all their referrals, visits and payouts. Preview dashboard (only for active affiliates) shows their dashboard exactly as they see it. It is read only, so nothing can be saved there.

Affiliates > Referrals lists every commission. Each row shows the Affiliate, the Order, the Type (sale or manual), the Commission, the Order base the commission was calculated on, the Status and the Date.

A commission moves through these statuses:

• pending: recorded and locked during the grace period.
• approved: payable. Pending commissions are approved automatically once the grace period has passed and the order is processing or completed.
• paid: included in a payout.
• rejected: you declined it.
• refunded: the order was refunded or cancelled.

Filter the list by status and type, then click Filter. Hover over a row to Approve a pending commission or Reject a pending or approved one. You can also tick several rows and use the Approve or Reject bulk action.

Add a manual referral

Use Add manual referral to credit an affiliate for a sale the plugin did not track, or to add a bonus:

1. Enter the Affiliate ID (the number in the affiliate's screen address, for example view=4).
2. Optionally enter the Order ID.
3. Enter the Amount and an optional Note.
4. Click Add referral.

The commission is recorded in your store currency and approved at once, so it counts toward the next payout.

Affiliates > Visits logs every click on a referral link: the Affiliate, the Landing page, the Referrer, the Device, a shortened IP, whether the visit Converted into an order, and the Date.

Bots and crawlers are filtered out, so they never create fake clicks. IP addresses are stored as hashes. If the WP Consent API plugin is installed, visits without marketing consent are still counted, but without IP or browser data.

Click Export CSV to download the visits you are looking at. The file follows the converted and affiliate filters you have applied.

Affiliates > Payouts is where you pay affiliates and keep a record of every payout.

Run payouts

Run payouts now shows how many affiliates are eligible. Click it to create a payout for every active affiliate whose approved balance reaches the Minimum payout. Each currency is paid as its own payout. Every payout gets a sequential invoice number such as AFF-2026-000001.

What happens next depends on the affiliate's payout method:

An affiliate with no payout method set is paid manually.

Finish manual payouts

1. Click Export awaiting payment (CSV) to get the list of payouts to send.
2. Send the money.
3. Hover over each payout and click Mark as sent. You can also use Mark all awaiting payment as sent, which appears while payouts are waiting.

Cancel puts the commissions back in the affiliate's balance, and the next run pays them. A failed payout can be tried again with Retry.

Exports and invoices

• Export unpaid balances (CSV): approved commissions that are not in any payout yet, per affiliate and currency, with a column showing whether each balance reaches the minimum.
• Export awaiting payment (CSV) and Export completed (CSV): payouts by status.
• View invoice opens a payout invoice. Use Print / save as PDF to keep a copy. Affiliates can open and print their own invoices from their dashboard.

Affiliates > Reports shows your program's results for any date range.

1. Choose the From and To dates and click Apply. The default range is the last 30 days.
2. Read the cards (Attributed revenue, Commissions, Visits, Conversion rate), the Visits per day and Commissions per day charts, and the Top affiliates table for that range.
3. To download commissions, optionally pick an Export status, then click Export referrals in range (CSV). The file contains the referrals in the selected dates and status.
4. Export affiliates (CSV) downloads your full affiliate list with balances.

Each commission is recorded in its order's currency. Report totals are not converted to one currency.

Affiliates > Tools has three areas.

Broadcast announcement

Send a message to every active affiliate. It appears in the notification feed of their dashboard (the bell icon), and also by email when Also send by email is checked.

1. Enter a Subject and a Message (HTML is allowed).
2. Leave Also send by email checked to email it too.
3. Click Send announcement. A notice tells you how many affiliates received it.

Data exports

Download Referrals (CSV) (every referral), Affiliates (CSV), Visits (CSV) (every visit) and Completed payouts (CSV).

Setup wizard

Re-run the setup wizard opens the welcome wizard again. Use it to change the basics in one place. If your affiliate page was deleted, the wizard can create a new one.

Affiliates > Settings opens on the Commissions tab. It decides how much affiliates earn on each referred order.

1. Set the Default commission: a number plus Percent of the order or Fixed amount per order. A percentage is applied to each order line. A fixed amount is paid once per order. Percentages cannot go above 100%.
2. Choose what the commission is based on: discounted line totals, tax and shipping.
3. Set a Minimum order amount if small orders should earn nothing.
4. Set the Grace period in days. Commissions stay pending this long, so an order refunded inside that window never reaches a payout.
5. Keep Block self referrals on so affiliates cannot earn on their own purchases.
6. Click Save settings.

In advanced mode (see the Advanced tab), this tab also shows New customers only, Claw back refunds after payout, and product, category and customer role exclusions.

Refunds are handled for you. A full refund or cancellation reverses the commission. A partial refund removes only the commission of the refunded lines (or a proportional part for an amount only refund). If the commission was already paid, it is deducted from the affiliate's next payout while Claw back refunds after payout is on (the default). A negative balance is never paid out.

The Tracking tab controls how long a click keeps crediting an affiliate.

Affiliates share links like https://yourstore.com/?ref=theirslug or the short form https://yourstore.com/go/theirslug/. They can also add ?ref=theirslug to any page or product link of your store. A click sets a signed, tamper resistant cookie. If the visitor buys before it expires, the order is credited to the affiliate. When several affiliates sent the same visitor, the most recent click gets the credit.

1. Set the Cookie duration in days (30 by default).
2. Decide whether the window ends after the first commission with Clear cookie on purchase.
3. Click Save settings.

In advanced mode you can also change the Referral URL parameter (ref) and the Pretty link base (go). If you change them, links your affiliates already shared that use the old word stop working.

The Affiliates tab controls who can join and what the signup form asks.

1. Check Auto approve to make new affiliates active at once. Leave it unchecked to review every application yourself.
2. Build the Signup form fields. Each row has a label (what applicants see), a key (where the answer is stored), a type and a Required checkbox. Drag the handle to reorder rows, click Add field for a new one, or Remove to delete one.
3. Write your Program terms. They are shown above the terms checkbox, which applicants must tick to apply.
4. Click Save settings.

In advanced mode, Terms version lets you raise the version number when your terms change, so each new application records which version was accepted.

The Payouts tab sets when affiliates are paid and which payout methods they can choose.

1. Set the Minimum payout. Run payouts now only pays affiliates whose approved balance reaches it.
2. Under Payout methods, check the methods affiliates may pick in their dashboard: Store credit coupon and Manual / offline.
3. Click Save settings.

If you uncheck every method, the plugin keeps Manual / offline so there is always a way to pay. If you stop offering a method an affiliate already chose, their payout fails with a notice until they choose another method or you pay them manually.

The Portal tab connects the affiliate dashboard page and sets its look.

1. Enter the Dashboard page ID: the ID of the page that contains [ppl_afw_portal]. To find a page ID, open the page in Pages and look at the number after post= in the address bar. The setup wizard fills this in when it creates the page.
2. Set the Accent color (a hex color such as #4f46e5) and the Corner radius (a size such as 10px) to match your theme.
3. Click Save settings.

In advanced mode you can also set a Separate signup page ID if you want the signup form on its own page.

The Advanced tab has two settings.

• Settings mode: Simple (recommended) hides the less common options. Advanced (show all options) shows them on the other tabs. Saving a tab in simple mode does not reset the hidden options.
• Delete data on uninstall: leave this unchecked unless you want all affiliate data removed when you delete the plugin.

When you open an order in WooCommerce > Orders, the Affiliate attribution box in the sidebar shows which affiliate the order was credited to, with their slug. View commissions for this order opens the Referrals screen filtered on that order. If no affiliate referred the order, the box says "No affiliate attributed to this order."

Commissions follow the order: when the order is completed after the grace period, its pending commission is approved. When the order is refunded or cancelled, the commission is reversed.

Affireo adds its emails to WooCommerce > Settings > Emails, where you can switch each one on or off and edit its subject and heading:

• New affiliate application: sent to the store admin when an application is submitted for review.
• Affiliate approved: sent to an applicant when they are approved.
• Affiliate rejected: sent to an applicant when their application is declined.
• New commission: sent to an affiliate when a new commission is recorded on their account.
• Payout sent: sent to an affiliate when their payout is sent. For store credit this is at once. For manual payouts it is when you mark the payout as sent.
• New referral (admin): sent to the store admin when an order is credited to an affiliate. It is off by default.

Affiliates can turn the New commission and Payout sent emails off for themselves under Email notifications on the Settings tab of their dashboard.

Everything affiliates see is on the page that holds [ppl_afw_portal].

Signing up

Visitors who are not logged in see a short invitation with Log in to apply and, when account registration is open in WooCommerce or WordPress, Create an account. After logging in, they come back to the page and see Join our affiliate program with your signup fields, your program terms and the checkbox I accept the affiliate program terms. They submit with Apply now. Pending applicants then see "Thanks for applying! Your application is under review and we will email you once it is approved."

The affiliate dashboard

Approved affiliates see the Affiliate Dashboard with four tabs:

• Dashboard: unpaid and lifetime earnings, visits and conversion rate for 30 days, an Earnings, last 30 days chart, achievement badges and Recent commissions.
• Links: their referral links with Copy buttons, and a Smart Link Studio that turns any page or product URL of your store into a referral link.
• Payouts: How should we pay you? to choose one of the payout methods you offer, plus Payout history with invoices they can open and print.
• Settings: change Your referral slug and choose which Email notifications they receive.

The bell icon opens their notifications, including your announcements. The dashboard works on small screens, supports light and dark mode, and still works with JavaScript off.

Toolbar shortcut

Active affiliates who are logged in get an Affiliate link item in the WordPress toolbar on your site. It gives them the referral link for the page they are viewing, with Copy this link.