Skip to content

Quick start

Quick start

Reseller Manager turns a single WHMCS instance into a multi-reseller platform: every reseller sees only their own clients, stats, and commissions. This guide covers install, your first reseller, and Pro features (commissions / pool / audit).

For WHMCS hosting providers needing multi-reseller architecture (white-label / team / regional agents).

1. Install and activate

  1. Download the ZIP matching your PHP version and extract into your WHMCS root.
  2. WHMCS admin → Setup → Apps & Integrations → Reseller Manager → Activate.
  3. Configuration → Addon Modules → tick admin role + license key + Save.
  4. Addons → Reseller Manager opens the console.

2. 8-page admin

  • Dashboard: current reseller count, client count, monthly commissions
  • Admins: mark an admin role as "reseller"
  • Customers: client-to-reseller mapping; filter / reassign
  • Pool: unassigned clients (Pro can auto-assign by rules)
  • Commissions (Pro): commission rates, monthly settlement
  • Statistics (Pro): per-reseller client count / revenue / commission
  • Audit log (Pro): operations log (who assigned / reassigned / deleted)
  • Settings: default commission rate, assignment rules, white-label

3. Add your first reseller

Admins page → find an admin → click "Mark as Reseller":

  • Set default client cap
  • Set commission rate (Pro)
  • Set pool permission

Once flipped, that admin logging into WHMCS only sees their own clients.

4. Client assignment

Customers page:

  • Full client list + current reseller marker
  • Single client → "Assign" → pick target reseller
  • Bulk → select rows + "Bulk Assign"
  • CSV export (Pro)

5. Pool (Pro)

Unassigned clients land in the pool. Operators manually claim or use auto-rules (by region / product / age / revenue).

6. Commissions (Pro)

  • Reseller's per-client invoice revenue × commission rate = commission
  • Monthly auto-settlement writes to reseller payable ledger
  • CSV export + WHMCS refund workflow (manual)

7. Statistics (Pro)

Per reseller: - Current client count / growth trend - Monthly revenue (including the reseller's own) - Commission paid / pending - Churn rate

8. Audit (Pro)

Logs every reseller-related operation: assign / reassign / delete / commission adjust. Tamper-proof (append-only).

9. Auto-updates

Dashboard "Check for Updates" panel pulls the latest version.

For deeper docs (reseller-scope SQL rewriting, commission algorithm, auto-assign rules) see the "Full documentation" link on your store dashboard card.