Documentation & User Guide

Everything you need to organize your affiliate links and your site's own links, manage your programs, and log and compare earnings across all your assets.

Overview

Afflemi is built around one core philosophy: every affiliate program you've joined, regardless of network or platform, is organized in one place, and every link you save is easy to find again. Because network APIs are fragmented or non-existent for creators, Afflemi is manual-first, so it works with any program, from global affiliate networks down to direct brand deals.

Afflemi also saves the normal links on your own site — blog posts, pillar pages, comparison pages — so every URL you reach for while writing is in one place: affiliate links and your site's own links alike.

The data model follows a simple, logical hierarchy:

AssetProgramLinks, Promotions, Payments, Notes, Contacts

An Asset is any channel where you publish content (Blog, YouTube, Newsletter, App, Socials). Each asset contains its specific affiliate Programs. Every affiliate link, payment record, note, or contact belongs to a specific program. Page Links — your site's own links — attach directly to an asset and live in /dashboard/links.

Dashboard Overview
Dashboard Overview
Main dashboard view showing active assets, recent link activity, and logged earnings.

Quick Start Guide

Setting up your account takes less than 5 minutes. Follow these four steps to get your links and programs organized:

1Create Your First Asset

Define your publishing channel (e.g., Tech Blog, YouTube Channel, Newsletter).

2Add Programs or Import CSV

Add affiliate programs manually or import your existing spreadsheet via CSV.

3Save Links & Placements

Save your affiliate links and your site's own page links — individually or imported from your site's sitemap — then tag where they are published on your site.

4Log Payments & Track Earnings

Record payouts as you receive them to build out your earnings charts and asset comparisons.

Quick Start Workflow
Quick Start Workflow
Visual walkthrough showing asset setup, program creation, and link logging.

Assets Management

Assets isolate your affiliate programs by publishing channel. This prevents blog programs from cluttering your YouTube channel or newsletter data.

  • Creating an Asset: Navigate to Assets → Add Asset. Choose a channel platform (Website, Newsletter, YouTube, Podcast, TikTok, Instagram, X, LinkedIn, App, or Other), name it, and enter optional handles/URLs.
  • Editing an Asset: Open the asset detail page and click Edit Asset to update names or descriptions.
  • Deleting an Asset: Accessible from the Edit view. Warning: Deleting an asset removes all programs, links, payments, notes, and contacts under it. A confirmation modal is required.
Assets Grid View
Assets Grid View
Assets page showing cards for each digital property, platform badges, and program counts.

Affiliate Programs

Inside any asset, click Add Program. The program wizard is organized into three sections:

  • Basic Information: Program name, company, platform network (e.g., Impact, ShareASale, In-house), approval status (approved, pending, rejected, not applied), date joined, and dashboard login URL.
  • Commission Terms: Commission rate (Percentage %, Flat $, or Both), recurring indicator, and cookie duration in days.
  • Payout & Status: Minimum payout threshold, payment frequency, payment method, and operational status (active, paused, removed).

Term Change History: When you update a program's commission rates, cookie window, or payout thresholds, Afflemi logs a timestamped snapshot under the Overview tab so you can look back at how the program's terms have changed.

Program Detail Overview
Program Detail Overview
Program overview page detailing current commission rates, status badges, and historical term logs.

CSV Import Wizard

Migrating from spreadsheets is effortless. Open any asset and select Import CSV:

  1. Download Template: Grab our sample CSV template or upload your existing spreadsheet.
  2. Smart Column Mapping: Map your CSV headers to Afflemi fields (Program Name, Company, Commission %, Status, etc.).
  3. Validation Preview: Review valid rows before importing. Incomplete or invalid rows are flagged automatically.
  4. 1-Click Undo: If an import doesn't look right, click Undo Import immediately after completion to revert all created programs safely.
CSV Import Field Mapping
CSV Import Field Mapping
Column mapping interface matching CSV headers to program database fields.

Import Page Links from a Sitemap

Have a site with dozens (or hundreds) of pages? Instead of saving each page link by hand, point Afflemi at your site's sitemap.xml and bulk-import your page links in one go.

  1. Open the dialog: Go to any asset's detail page, open the Page Links tab, and click Import from Sitemap.
  2. Enter the sitemap URL: Paste the sitemap URL (e.g. https://yoursite.com/sitemap.xml). Optionally filter to only paths containing a string (e.g. /blog/) and set a maximum number of links to fetch (up to 500). Leave the filter empty to include every URL in the sitemap.
  3. Preview & select: Afflemi fetches the sitemap and shows a table of found links with auto-generated titles. Check or uncheck any row — everything is selected by default — then click Import N links.
  4. Done: The links are saved as page links under that asset. URLs you've already saved are skipped automatically (deduplicated by URL), so re-importing after publishing new posts is safe.

Imported links appear in the asset's Page Links tab and in the global Page Links page, searchable by title — ready to be found by the browser extension while you write.

Sitemap import — URL, path filter, and limit
Sitemap import — URL, path filter, and limit
Import dialog where you paste your sitemap URL, optionally filter by path, and set a fetch limit.
Sitemap import — link preview
Sitemap import — link preview
Preview table of links found in the sitemap, with checkboxes to pick exactly which ones to import.
Sitemap import — success
Sitemap import — success
Confirmation after importing, including how many links were added and how many were skipped as already saved.

Where Links Are Used (Promotions)

Never lose track of where your affiliate links are published. Attach placement entries to any link (Blog article, Landing page, Comparison page, Newsletter, YouTube description, Social post).

  • Clean Badge Preview: Each link card displays a clean preview of its primary location. If used in multiple pages (e.g. 10 articles), a +9 more badge appears.
  • Manage Locations Modal: Click Manage all to open a full modal list of published locations. You can view target URLs, add new locations, and edit or delete existing entries with single-click controls.
Link Locations Modal
Link Locations Modal
Modal interface listing all published placement locations with inline edit and delete capabilities.

Install & Connect the Extension

The Afflemi browser extension puts your whole link vault — affiliate links and page links — in a side panel you can open from any tab, so you can search and copy links while you write.

  1. Install: Add the extension from the Chrome Web Store (also works in Edge, Brave, and other Chromium browsers).
  2. Pin it: Click the puzzle icon in your browser toolbar and pin Afflemi so the icon stays visible.
  3. Open the panel: Click the Afflemi icon or press Alt + A to open the side panel.
  4. Connect: On first use, click Connect Afflemi. You'll be signed in to your existing Afflemi account, and the panel unlocks. This is a one-time setup — after that, the extension keeps you signed in automatically.
  5. Disconnect: Use the power button in the panel header at any time to disconnect and clear the locally stored session.
Connecting the Afflemi extension
Connecting the Afflemi extension
One-time connect flow linking your Afflemi account to the browser extension.

Quick Save From Any Tab

Just joined a program or saved a page worth reusing? Save it without leaving the tab you're on.

  • Save an affiliate link: Use the Save Affiliate Link tab. Pick the asset, choose an existing program or type a new one, name the link, and paste the tracking URL. A new program is created automatically if needed.
  • Save a page link: Use the Page Links tab. Pick the asset, and the title of the page you're currently viewing is pre-filled for you — just add the URL and save.
  • Saved instantly: Both types land in your vault (and in the web app) immediately, so they're searchable the next time you open the panel.
Quick saving an affiliate link
Quick saving an affiliate link
Quick save form for affiliate links with program selection or creation.
Saving a page link
Saving a page link
Page Links tab with the active tab's title pre-filled for quick saving.

Extension Troubleshooting

  • Session expired: The extension refreshes your session automatically. If a refresh fails and the panel shows the Connect screen, click Connect Afflemi once to sign back in — your links are untouched.
  • Extension not connecting: Make sure you're signed in to Afflemi in the browser, then retry the connect flow.
  • Your data: The extension reads your active tab's title only when you use the save feature, stores your session tokens locally on your device, and sends the same data the web app does. See the Privacy Policy for details.

Logging Payments

Log payouts from individual program detail pages or globally via /dashboard/payments.

Payment status definitions:

  • Received Payout confirmed & deposited. Counts directly toward revenue totals.
  • Pending Approved payout waiting for disbursement.
  • Expected Estimated earnings for the current cycle.
  • Missed Overdue or uncollected payout requiring follow-up.
Global Payments Log
Global Payments Log
Payments dashboard showing status summaries, program filters, and transaction history.

Notes & Affiliate Contacts

Maintain strong relationships and clear communication logs for every program:

  • Program Notes: Timestamped journal entries for storing coupon codes, rate negotiations, or promo guidelines. Notes are append-only so relationship history is never lost.
  • Affiliate Contacts: Store affiliate manager emails, Slack channels, Discord handles, and phone numbers. Search all contacts globally at /dashboard/contacts.
Affiliate Contacts Directory
Affiliate Contacts Directory
Centralized contact directory for affiliate managers across all active programs.

Programs Catalog

The Programs page (/dashboard/programs) offers a flat, cross-asset catalog of every affiliate program you maintain. Features a responsive 3-column card grid with live debounced search by program or company name.

Programs Catalog Grid
Programs Catalog Grid
Responsive 3-column card grid listing all programs across all digital assets.

Earnings Analytics & Comparisons

Log your earnings as you receive them, and see the trend and compare performance across channels on the Earnings page (/dashboard/earnings).

  • Flexible Date Ranges: View 3-month, 6-month, 12-month, or custom date ranges.
  • 4 Analysis Modes: Switch between Overall, By Asset, By Program, and Side-by-Side Comparison mode.
  • Smart Aggregation: Shorter date ranges (under 90 days) automatically group by week for granular tracking, while longer ranges group by month.
Earnings & Comparison Analytics
Earnings & Comparison Analytics
Interactive chart comparing logged earnings between two assets or programs over time.