Skip to content
Management

WHMCS Reseller Setup Guide: Native Options and the Reseller Module

WHMCS natively sells cPanel reseller hosting, group discounts and affiliate commissions. Branded resellers with their own sub-clients need a module such as WHMCSPilot's Reseller Module.

WHMCSPilot Team Published Updated 9 min read
WHMCS Reseller Setup Guide: Native Options and the Reseller Module

A reseller setup in WHMCS can mean four different things: selling cPanel reseller hosting, giving partners wholesale pricing, paying affiliates for referrals, or letting partners manage their own customers under their own brand. Core WHMCS handles the first three with built-in features. The fourth, where a reseller's end customers sit under the reseller's account instead of becoming your clients, needs a module such as WHMCSPilot's Reseller Module. This guide covers both, for WHMCS 8.13 and 9.x as of November 2026.

Key takeaways

  • WHMCS sells cPanel reseller hosting natively through the cPanel module's Reseller Hosting product type and a WHM reseller ACL.
  • Client Groups give resellers a percentage discount on future invoices without any module.
  • Since WHMCS 8.0, one user can manage several client accounts, but each end customer is still a separate client on your license.
  • WHMCS licenses are priced by active clients, meaning clients with at least one active product, service, addon or domain.
  • WHMCSPilot's Reseller Module is listed at $499 and adds sub-clients under a reseller account, fixed margins and a white-label client area for resellers.

What does "reseller" mean in WHMCS?

"Reseller" in WHMCS covers several business models, and each one uses a different feature:

ModelWhat the partner doesWHMCS featureModule needed?
Reseller hostingBuys a WHM reseller account and creates cPanel accountscPanel module, Reseller Hosting product typeNo
Wholesale pricingBuys your products at a discount for their customersClient Groups with a group discountNo
Referral partnerSends customers to you for a commissionAffiliatesNo
Branded reseller with sub-clientsSells your products under their brand and manages their own customersNot in core WHMCSYes, or the reseller runs their own WHMCS

The terms overlap, so the WHMCS glossary is useful when you write your reseller terms.

How do you sell cPanel reseller hosting with WHMCS?

cPanel reseller hosting in WHMCS uses the built-in cPanel module, so WHMCS creates a WHM reseller account when the order is paid. According to the WHMCS cPanel module documentation, the setup is:

  1. In WHM, create a reseller ACL under Resellers > Edit Reseller Nameservers and Privileges that lists what resellers may do.
  2. In WHMCS, create a product with the Reseller Hosting product type and select the cPanel module.
  3. On the Module Settings tab, leave the WHM Package Name blank and switch to Advanced Mode.
  4. Enter the name of your WHM ACL in Reseller ACL List.
  5. Set Limit Reseller by Number, Limit Reseller by Usage, Reseller Disk Space, Reseller Bandwidth, Allow DS Overselling, Allow BW Overselling, Configure Nameservers and Reseller Ownership. Any value left empty is unlimited, so fill in every limit you intend to enforce.
  6. Make sure the server in WHMCS uses a WHM API token with the "Everything" permission, because reseller functions need root access.

A WHM reseller account controls server resources only. It does not decide who invoices the end customer or where that customer logs in, so you may need one of the billing options below as well. WHMCSPilot's reseller hosting business setup covers the WHM and WHMCS side together.

How do you give resellers wholesale pricing in core WHMCS?

Wholesale pricing in core WHMCS comes from Client Groups at Configuration > System Settings > Client Groups. The Client Groups documentation lists these options:

  • Group discount: a percentage that applies to all future invoices for clients in the group. WHMCS applies it at the invoice stage, so it does not appear at checkout. Tell resellers that, or they will open tickets about cart prices.
  • Exempt from suspend and terminate: keeps services running when a trusted reseller pays late. It does not apply to fixed-term or free trial products.
  • Separate invoices: one invoice per service, which helps resellers rebill each customer.
  • Domain pricing slabs: different domain prices for the group, set under Domain Pricing.
  • Group colour: flags reseller accounts in the client list and on tickets.

Client Groups work when resellers order on behalf of their customers and handle the customer relationship outside your WHMCS. They do not give the reseller a separate brand or a way to manage their own customer list inside your install.

Can resellers manage their customers' accounts in core WHMCS?

Resellers can manage several client accounts with one login in core WHMCS, through the users and client accounts model introduced in WHMCS 8.0. Each end customer is a client account, and the account owner can invite the reseller as a user with chosen permissions from User Management in the client area. One user can then switch between every account they have been invited to. The users and client accounts documentation describes the full permission model, and the Client Area User Management option on the Other tab of General Settings turns invitations off if you do not want them.

Two limits matter for a reseller program. Every end customer is a full client on your install, so each one with an active service counts toward your license. And every customer sees your brand, your invoices and your support desk.

Should partners be affiliates instead of resellers?

Partners who only send customers to you fit the WHMCS affiliate system better than a reseller setup. The customer becomes your client, pays your prices, and the partner earns a commission. The Affiliates tab of General Settings sets the Affiliate Earning Percentage (overridable per product or per affiliate), an optional Affiliate Bonus Deposit, the minimum Affiliate Payout Amount, and the Affiliate Commission Delay, for which WHMCS suggests 30 or 60 days so refunds and chargebacks clear first.

What does WHMCSPilot's Reseller Module add?

WHMCSPilot's Reseller Module covers the branded reseller model. Its listing describes resellers creating unlimited clients under their own account without adding to your WHMCS client count, and lists these features:

  • Unlimited sub-clients under reseller accounts
  • Fixed margin pricing per reseller
  • White-label client area and custom branding per reseller
  • Reseller dashboard with analytics
  • Automated commission tracking
  • Product access control per reseller
  • Bulk operations for resellers

The module is listed at $499 with a $99 support renewal, and its compatibility is listed as WHMCS 8.13 with PHP 8.1+. WHMCS 9.x requires PHP 8.2 or later and 8.13 reaches end of life on December 31, 2026, so confirm 9.x support before you plan the WHMCS 9 upgrade.

NeedCore WHMCSWith the Reseller Module
Reseller discountPercentage group discount at invoice stageFixed margin per reseller
Reseller's own customer listSeparate client accounts the reseller is invited toSub-clients under the reseller account
Reseller brandingOne brand per installationWhite-label client area per reseller
Which products a reseller can sellAll public productsProduct access control per reseller
Commission and sales reportingAffiliates for referrals onlyCommission tracking and reseller dashboard

How do you set up the Reseller Module step by step?

Setting up the Reseller Module goes faster when the business rules are decided before anything is installed:

  1. Write the policy. Decide who can become a reseller, the margin model, which products resellers may sell, whether sub-clients see your brand or the reseller's, and who answers sub-client support.
  2. Back up WHMCS. Take a database and file backup before adding any module.
  3. Install the module. Upload it as its instructions describe. WHMCS addon modules normally live in /modules/addons/ and are activated at Configuration > System Settings > Addon Modules, where you also grant admin role access.
  4. Set product access. Choose which products each reseller, or group of resellers, may sell.
  5. Set margins. Enter the fixed margin for each reseller.
  6. Configure branding. Add each reseller's logo and details for the white-label client area.
  7. Test end to end. Create a test reseller with two sub-clients, then run an order, a renewal and a suspension, and check commission tracking against the test order.
  8. Check the license count. Note the Active Client Count at Help > License Information before and after the test, so you can see how WHMCS counts the new records.
  9. Brief resellers. Send a short guide on adding sub-clients, placing orders and getting help.

How does a reseller setup affect WHMCS license cost?

WHMCS license cost depends on active clients, so the reseller model you choose changes the bill. Self-hosted prices on whmcs.com/pricing at the time of writing (November 2026), excluding tax, are Plus at $34.95 a month for up to 250 active clients, Professional at $54.95 for up to 500, and Business from $84.95 for up to 1,000. Take a host with 200 direct clients and 10 resellers who each bring 50 customers:

SetupActive clientsTier and monthly price
End customers as normal clients700Business, $84.95
End customers as sub-clients that stay out of the count210Plus, $34.95

The $50 monthly difference is $600 a year, against the module's listed $499. That math holds only if your Active Client Count really excludes sub-clients, so confirm it on your own install and read the WHMCS license terms before you rely on it. For other ways to lower the bill, see how to reduce WHMCS licensing costs, and for platforms with different license models, the WHMCS, Blesta, HostBill and Upmind comparison.

Who should support a reseller's customers?

Reseller support needs a written rule, because end customers will contact whoever they can find. The three common models are direct support, where you answer end customers; tiered support, where resellers handle first-line questions and escalate to you; and full delegation, where resellers handle everything and you support only the reseller. Put the model in your reseller terms, match the branding to it, and give resellers a ticket department of their own so escalations do not mix with retail tickets.

Frequently asked questions

Does WHMCS have a built-in reseller module?

Not for branded resellers with their own sub-clients. Core WHMCS sells cPanel reseller hosting, offers group discounts through Client Groups and runs an affiliate program, but sub-clients under a reseller account need a module.

Do a reseller's customers count toward my WHMCS license?

If they are normal client accounts with an active product, service, addon or domain, yes. WHMCSPilot's Reseller Module is described as keeping sub-clients out of your client count, so check Help > License Information after setup to confirm it on your install.

Is a WHM reseller account the same as a WHMCS reseller?

No. A WHM reseller account lets someone create cPanel accounts on your server, while a WHMCS reseller setup decides pricing, invoicing and who manages the end customer. You can run both together.

Can resellers use their own branding in WHMCS?

Not in core WHMCS, which uses one company name, logo and set of email templates per installation. Per-reseller branding needs a module with a white-label client area, or the reseller running their own WHMCS license.

Does the Reseller Module work with WHMCS 9?

Its listing gives WHMCS 8.13 and PHP 8.1+ compatibility. WHMCS 9.x requires PHP 8.2 or later, so confirm 9.x support with WHMCSPilot before upgrading.

If you would rather have resellers, margins and branding configured and tested for you, WHMCSPilot's Reseller Module setup service covers it. IPTV operators selling through credit-based resellers should also read WHMCS vs a standalone IPTV billing portal.