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
- Download the ZIP matching your PHP version and extract into your WHMCS root.
- WHMCS admin → Setup → Apps & Integrations → Reseller Manager → Activate.
- Configuration → Addon Modules → tick admin role + license key + Save.
- 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.