How can we help you?

1. Log into your WordPress admin (e.g. yourstore.com/wp-admin).
2. In the left sidebar, click Plugins → Add New.
3. At the top of the page, click the Upload Plugin button.
4. Click Choose File and select the afflyr.zip file you downloaded after purchase.
5. Click Install Now, then click Activate Plugin.
6. You'll now see Afflyr in your WordPress sidebar.

1. Check the email you received after purchase — your license key is included.
2. In WordPress admin, go to Afflyr → Account (or you'll see a banner at the top prompting you to activate).
3. Paste your license key into the field.
4. Click Agree & Activate License.
5. You should see "License Active" and Pro/Business features will unlock based on your plan.

1. After activating, you'll see a Setup Wizard banner — click Start Wizard. (Or go to Afflyr → Setup.)
2. Step 1 — Commission: Set your default commission rate (e.g. 15 for 15%). Choose Percentage or Flat.
3. Step 2 — Cookie Duration: Choose how long a referral is tracked after click (30, 60, or 90 days). We recommend 60.
4. Step 3 — Approval Mode: Choose Auto-approve (anyone can sign up) or Manual (you review each application).
5. Step 4 — Portal Page: Afflyr will create a /affiliates page automatically, or you can pick an existing page.
6. Click Finish. Your affiliate program is live.

Afflyr requires WooCommerce 6.0 or newer and WordPress 5.8+.

1. WooCommerce must be installed and activated.
2. You need at least one product (physical, digital, or subscription).
3. Afflyr fully supports WooCommerce HPOS (High-Performance Order Storage) — no action needed on your side.
4. WooCommerce Subscriptions is supported out of the box for recurring commissions.

1. Go to Afflyr → Dashboard.
2. Top cards show: total affiliates, pending referrals, unpaid commissions, total paid out.
3. Chart shows referrals over the last 30 days — adjust the date range using the dropdown.
4. Top Affiliates leaderboard ranks affiliates by conversions or revenue.
5. Recent Activity feed shows new signups, referrals, and payouts.

1. When a new version is released, you'll see an update notification in WordPress → Plugins.
2. Click Update now under Afflyr.
3. Updates apply automatically without disrupting your affiliates or referrals.

1. Go to Afflyr → Affiliates.
2. Click the Add New Affiliate button (top right).
3. Enter their First Name, Last Name, and Email.
4. Optionally set a custom referral code (e.g. jane) — otherwise one is auto-generated.
5. Optionally set a custom commission rate (e.g. 20 for 20%) and choose Percentage or Flat. Leave blank to use your default rate.
6. Click Create Affiliate.
7. The affiliate automatically receives a welcome email with their referral link and coupon code.

1. Go to Afflyr → Affiliates.
2. Find the affiliate in the list and click Edit in their row.
3. From the edit screen you can update: commission rate & type, payment email, status, website, notes, and referral code.
4. Click Save Changes at the bottom.

1. Go to Afflyr → Affiliates and click the Pending tab.
2. Review the application details.
3. Click Approve to activate the affiliate — they'll receive an approval email with their referral link.
4. Or click Reject. You'll be asked for an optional reason that's included in the rejection email.

1. Go to Afflyr → Affiliates.
2. Click Delete in the affiliate's row.
3. Confirm the deletion in the popup.

1. Go to Afflyr → Affiliates.
2. Check the box next to each affiliate you want to act on (or use the header checkbox to select all on the page).
3. Choose an action from the Bulk Actions dropdown: Approve, Reject, or Delete.
4. Click Apply and confirm.

1. Go to Afflyr → Settings → General.
2. Toggle Open Applications off to hide the registration form.
3. Set a Custom Portal Welcome Message to show visitors what to do instead (e.g. "We're not accepting new affiliates right now").
4. Save changes.

1. Go to Afflyr → Affiliates and click Edit on the affiliate.
2. Update the Referral Code field to their desired slug (e.g. jane).
3. Click Save. Their new referral link becomes yourstore.com/?ref=jane.

1. Go to Afflyr → Affiliates.
2. Use the tabs at the top to filter by status: All, Active, Pending, Rejected, Inactive.
3. Type in the search box to find by name, email, or referral code.

1. Go to Afflyr → Settings → Commissions.
2. Enter your new Default Commission Rate. Example: 15 for 15%.
3. Choose the Type: Percentage of order or Flat amount per order.
4. Click Save Changes.

1. Go to WooCommerce → Products and click the product you want.
2. Scroll down to the Afflyr Commission metabox on the right sidebar.
3. Enter a custom rate and choose Percentage or Flat.
4. Or check Exclude from commissions to pay $0 commission on this product.
5. Click Update to save the product.

1. Go to Products → Categories.
2. Click Edit on the category.
3. Find the Afflyr Commission Rate field and enter the rate.
4. Click Update.

1. Go to Afflyr → Settings → Commissions.
2. In the Excluded Products field, type the product name and select from the dropdown (or paste product IDs separated by commas).
3. Do the same for Excluded Categories.
4. Click Save Changes.

1. Go to Afflyr → Settings → Commissions.
2. Find the Commission Base setting.
3. Choose After Discount (default, most common) to calculate commission on the discounted subtotal.
4. Or choose Before Discount to calculate on the pre-discount price.
5. Save.

1. Go to Afflyr → Settings → Commissions.
2. Toggle Pay commission on first purchase only to limit commissions to each customer's first order.
3. Toggle Block self-referrals to prevent affiliates from getting paid when they buy through their own link.
4. Save changes.

Afflyr uses three tracking methods, all server-side and AdBlock-proof:

1. Referral link — when someone visits yourstore.com/?ref=jane, a first-party cookie is set for your configured duration (30/60/90 days).
2. Coupon code — each affiliate gets a unique WooCommerce coupon. Any order using it gets credited.
3. Direct link — affiliates can share specific product URLs like yourstore.com/product/name/?ref=jane.

When an order completes, Afflyr checks cookies and coupons and creates a referral record with the correct commission.

1. Go to Afflyr → Settings → Tracking.
2. Pick Cookie Duration: 30, 60, or 90 days.
3. Save.

1. Go to Afflyr → Referrals.
2. Use the tabs at the top to filter by status: Pending, Approved, Paid, Rejected.
3. Filter by date range, tracking method (link/coupon/direct), or amount range.
4. Click an individual referral to see the order, affiliate, and commission details.

1. Go to Afflyr → Referrals and click the referral.
2. Adjust the commission amount (useful for partial refunds) or status.
3. Click Save. Or click Delete to remove entirely.

Afflyr automatically reverses referrals when an order moves to:

1. Refunded — the linked referral is auto-rejected and commission is cleared.
2. Cancelled — same as refunded.
3. Failed — same.

You don't need to do anything — Afflyr listens for WooCommerce order status changes and reverses the referral on its own.

1. Go to Afflyr → Referrals.
2. Apply any filters you want (date range, status, etc.).
3. Click the Export CSV button at the top right.
4. The CSV will download with all filtered referrals.

1. Go to Afflyr → Payouts.
2. Find the affiliate and click Create Payout.
3. Review the approved referrals that will be included.
4. Pick a payment method: PayPal, Stripe, Store Credit, or Manual.
5. Click Pay Now. For PayPal/Stripe, Afflyr sends funds automatically. For Manual, you pay outside the platform and Afflyr records it.

1. Go to Afflyr → Payouts.
2. Click Pay All Eligible.
3. Afflyr lists every affiliate whose approved balance is above your minimum payout threshold.
4. Pick the payment method and click Confirm.

1. In PayPal developer dashboard, create an app and get your Client ID and Secret.
2. In WordPress, go to Afflyr → Settings → Payouts → PayPal.
3. Paste your Client ID and Secret.
4. Choose Live mode (or Sandbox for testing).
5. Click Save and then Test Connection.
6. Affiliates must have a payment email set on their profile that matches a PayPal account.

1. Get your Stripe Secret API Key from the Stripe dashboard.
2. Go to Afflyr → Settings → Payouts → Stripe.
3. Paste the key and save.
4. Affiliates need to connect their Stripe account — they'll see a "Connect Stripe" button in their affiliate portal.

1. Go to Afflyr → Payouts.
2. Find the payout in the list and click Void.
3. Confirm. The referrals included in that payout are restored to Approved so they can be re-paid later.

1. Go to Afflyr → Payouts.
2. Use the filters (date range, method, affiliate) to narrow the list.
3. Click Export CSV.

1. Go to Afflyr → Settings → Emails.
2. Pick an event: Welcome, Approval, Rejection, New Referral, Payout Sent, or Admin Notification.
3. Edit the subject line and email body. Both support merge tags (see next tutorial).
4. Click Save.

Use these in any email subject or body — they get replaced with real values when sent:

1. {affiliate_name} — the affiliate's full name
2. {referral_code} — their referral slug (e.g. "jane")
3. {referral_link} — full link including ?ref=
4. {coupon_code} — their auto-generated coupon
5. {portal_url} — their dashboard URL
6. {site_name} — your store name
7. {commission_amount} — formatted commission (new referral / payout emails only)
8. {order_id} — the WooCommerce order (new referral email only)
9. {rejection_reason} — the reason you entered (rejection email only)

1. Check the recipient's spam / junk folder first.
2. Make sure your WordPress general From email matches a real inbox on your domain.
3. For reliable delivery, install an SMTP plugin (e.g. FluentSMTP, WP Mail SMTP) and route through SendGrid / Postmark / Mailgun.
4. Add SPF, DKIM, and DMARC DNS records for your domain to pass Gmail/Outlook filters.

1. Go to Afflyr → Settings → Emails.
2. Toggle the switch next to any event you don't want to send.
3. Save.

1. During setup, Afflyr automatically created a page at yourstore.com/affiliates.
2. It contains the shortcode [afflyr_portal].
3. Affiliates log in using their WordPress account (the email on their affiliate profile).
4. You can move the shortcode to any other page or use a custom URL — just make sure the URL is set in Afflyr → Settings → General → Portal Page.

The portal has 4 tabs:

1. Overview — clicks, conversions, earnings, balance, referral link, coupon code.
2. Referrals — every tracked referral with status and commission.
3. Payouts — payout history plus a Request Payout button.
4. Profile — edit payment email, website, and notes.

Yes. From the Profile tab in the portal, affiliates can update:

1. Payment email (PayPal address)
2. Website URL
3. Notes about their promotion plan

Referral code and commission rate can only be changed by you from the admin.

1. On the Payouts tab, affiliates see their approved balance.
2. If the balance meets your minimum threshold, a Request Payout button is enabled.
3. They click it. You get an admin notification and can process the payout from Afflyr → Payouts.

1. Visitors who are not logged in see a signup form on your portal page.
2. They enter first name, last name, email, and preferred referral code.
3. They must check the Terms & Conditions box.
4. Honeypot spam protection is built in — bots are silently rejected.
5. On submit, if auto-approve is on, they're immediately active. Otherwise the application lands in Pending for your review.

Check these in order:

1. Did the customer actually click the referral link (or use the coupon) before checkout?
2. Did they use an incognito / private window that clears cookies between sessions?
3. Is the order status Processing or Completed? Pending / Failed orders don't trigger referrals.
4. Is the product or category on your Excluded list?
5. Is the affiliate Active? Pending or Rejected affiliates don't earn.
6. Is the customer the affiliate themselves (if self-referral blocking is on)?

1. Copy the key fresh from your purchase email — no spaces at the start/end.
2. Check that your site URL in the license is correct. If you moved your site, deactivate the old activation in users.freemius.com.
3. Confirm your subscription isn't cancelled or expired in that same dashboard.
4. If stuck, email [email protected] with your order number.

1. Check the product's metabox — it may have a custom rate overriding the default.
2. Check the affiliate's custom rate on their edit page.
3. Check the commission base: pre-discount vs post-discount.
4. Check if any items in the order were on the Excluded Products list (they're skipped from the calculation).

1. Go to Pages in WordPress and confirm the Affiliates page exists.
2. Edit it and make sure the shortcode [afflyr_portal] is in the page content.
3. Go to Settings → Permalinks and click Save Changes (this flushes rewrite rules).

1. Check that the affiliate's payment email is a valid PayPal account.
2. Confirm your PayPal business account has sufficient balance.
3. Check the failure reason in Afflyr → Payouts — click the failed payout to see PayPal's error message.
4. Common issues: currency mismatch, PayPal account is unverified, country restrictions.

1. Use a proper SMTP service (SendGrid, Postmark, Mailgun, Amazon SES) instead of your host's default mail.
2. Add SPF, DKIM, and DMARC DNS records for your sending domain.
3. Never use a Gmail / Yahoo address as the "From" — use [email protected].

1. Enable WordPress debug mode — add define('WP_DEBUG', true); to wp-config.php.
2. Reload and note the error message.
3. If it references another plugin, try deactivating plugins one by one to find the conflict.
4. Confirm your PHP version is 7.4 or higher (Afflyr requires 7.4+, recommends 8.0+).
5. Email [email protected] with the error message and your environment details.

Affiliate — a person promoting your store. Referral — a single order attributed to that affiliate. Commission — the money earned on that referral.

No. All plans include unlimited affiliates, referrals, and commissions. Afflyr never charges per-affiliate.

7-day risk-free, no-questions-asked. Email [email protected] within 7 days of purchase and we'll refund in full.

Yes — every plan includes a 3-day free trial. You won't be charged until day 4.

Yes. See our migration guide or email support — we'll help you import affiliates, referrals, and payouts for free.

Yes. Business plans support network activation. Pro and Starter run per-subsite with a separate license per install.

Yes. If you use WooCommerce Subscriptions, every renewal payment generates a new referral and commission automatically.

Yes. Afflyr uses first-party cookies only, stores no personal data of site visitors beyond the attribution cookie, and supports WordPress core's data export / erasure tools for affiliates.

Afflyr gives you CSV exports of all payouts with amounts and dates. You can collect W-9 / W-8BEN details via notes on each affiliate. Filing itself is on you.

Yes — available on Pro and Business. Read, create, and update affiliates, referrals, and payouts. Webhooks fire on key events.

Starter: 48-hour response. Pro: 24-hour priority. Business: 12-hour priority plus live chat during business hours.

Log into your account page and click Cancel Subscription. Your license stays active until the end of the billing period, then updates stop but the plugin keeps running.