WHMCS Glossary: Provisioning Module, Hooks and 35 More Terms
A WHMCS provisioning module, also called a server module, links a product to a panel or API so WHMCS can create, suspend and terminate accounts. Plus 36 more WHMCS terms.
A WHMCS provisioning module, also called a server or product module, is the PHP code that connects a product to a control panel or service API so WHMCS can create, suspend, unsuspend and terminate accounts on its own as orders are paid and invoices go overdue. This glossary defines that term and 36 others you'll meet in the WHMCS admin area, docs and module listings. Definitions and menu paths follow the WHMCS 9.1 documentation, and most also apply to 8.13.
Key takeaways
- Provisioning (server) modules live in
/modules/servers/, registrar modules in/modules/registrars/, gateway modules in/modules/gateways/and addon modules in/modules/addons/. - Configurable options change a product's own price; product addons are billed as separate items.
- The system cron drives invoicing, reminders, suspensions and domain sync; nothing automated happens without it.
- MarketConnect is WHMCS's own reselling platform; the Marketplace is the directory of third-party add-ons.
- WHMCS 9.0 added credit and debit notes, the Nexus Cart order form and Smarty 4.0, and WHMCS 9.1 requires ionCube Loader 15.0.0.
Products and billing
Product and service
A product is something you sell, set up at Configuration > System Settings > Products/Services and organized into product groups on the order form. When a client orders it, WHMCS adds that client's own copy, called a service, with its own status, billing cycle and next due date.
Configurable option
A configurable option is a choice that changes a product's price, such as extra RAM, disk space or IPTV connections. You define configurable options in groups at Configuration > System Settings > Configurable Options and apply each group to one or more products (WHMCS docs). The Price Manager Option module prices the same option differently per client or group.
Product addon
A product addon is an extra item a client can select, such as backups or a dedicated IP, that WHMCS bills separately from the main product. Addons are managed at Configuration > System Settings > Product Addons, and predefined addons sell cPanel or Plesk features such as WP Toolkit Deluxe.
Product bundle
A product bundle is an order link that adds two or more products, or products and domains, in one order, usually at a discount. Bundles are created at Configuration > System Settings > Product Bundles. The Aqua-Sky-Pack module adds discounted bundles with automatic provisioning of every item.
Invoice
An invoice is the bill WHMCS issues for services and domains. The cron generates renewal invoices ahead of each next due date, and admins can create one-time invoices at Billing > Invoices, which stay in Draft until published. In WHMCS 9.x, published invoices can't be edited directly by default.
Credit balance
A credit balance is money held on a client's account that can pay any unpaid invoice. WHMCS credits overpayments automatically, clients can deposit funds in advance, and admins can add credit, ideally tied to a transaction so the Account Statement report balances.
Credit note and debit note
Credit and debit notes are billing documents that WHMCS 9.0 introduced so invoices stay unchanged after publishing. A credit note reduces an invoice balance, for example on a cancellation or refund, and a debit note increases it. WHMCS 9.1 added the Invoice Immutability setting on the Invoices tab of General Settings.
Quote
A quote is an estimate sent from Billing > Quotes that WHMCS converts to an invoice when the client accepts, creating the client account at that point for a new customer. Adding a predefined product copies its price but doesn't create the service, so you add the order after payment.
Modules and extensions
Provisioning module
A provisioning module connects a WHMCS product to the system that delivers it, such as a control panel, VPS platform or IPTV panel. Its core job is creating, suspending, unsuspending and terminating accounts on payment, overdue invoices and cancellations, and it can also handle upgrades, renewals, password resets, client area output and usage metrics (WHMCS developer docs). Our IPTV panel modules are examples, and our guide to developing custom WHMCS modules covers building one.
Server module
Server module is another name for a provisioning module, used in the admin area where each module is paired with a server record added at Configuration > System Settings > Servers. Servers can be grouped into server groups for products. WHMCS ships server modules for cPanel, Plesk, DirectAdmin, InterWorx, Virtualizor and SolusVM, among others.
Registrar module
A registrar module, also called a domain module, connects WHMCS to a domain registrar to register, transfer, renew and manage domains. Registrar modules live in /modules/registrars/ and are activated at Configuration > System Settings > Domain Registrars; bundled ones include Enom, Namecheap, OpenSRS, ResellerClub and Nominet.
Addon module
An addon module extends WHMCS with features not tied to one product, such as admin pages, client area pages, reports or integrations. Addon modules are activated at Configuration > System Settings > Addon Modules, with access set per admin role, and then appear in the Addons menu. Deactivating one may delete its data.
Gateway module
A payment gateway module lets WHMCS take payments through a processor. Third-party gateways send the customer to the processor's page, merchant gateways take the card inside WHMCS and charge it by API, and tokenized gateways store a token for future billing. See our payment gateway modules.
Mail provider
The mail provider is the method WHMCS uses to send system email: PHP Mail (the default), SMTP, Google, Microsoft, Mailgun, SendGrid or SparkPost, chosen on the Mail tab of General Settings. Developers can add more as mail provider modules. When mail fails, see why WHMCS emails stop sending.
Marketplace
The WHMCS Marketplace is WHMCS's directory of third-party add-ons and extensions, and the account behind MarketConnect. New WHMCS 9.1 installs must connect a Marketplace account before the admin area opens, and WHMCS Cloud supports only pre-approved Marketplace modules.
MarketConnect
MarketConnect is WHMCS's built-in platform for reselling services such as SSL certificates, SiteLock, Weebly, SpamExperts and marketgoo. You deposit funds into your Marketplace account, activate products at Configuration > System Settings > MarketConnect, and WHMCS sets up the products, automation, landing pages and promotions.
Automation
Cron (system cron)
The system cron is a scheduled job that runs crons/cron.php, ideally every five minutes, to generate invoices, capture payments, send reminders, suspend services and sync domains. Utilities > Automation Status shows whether it's running, and since 9.0 HTTP requests to cron.php are blocked by default. See what to do when the WHMCS cron isn't running.
Automation Settings
Automation Settings, at Configuration > System Settings > Automation Settings, control what the cron does and when: the daily run time, how far ahead invoices are generated, when overdue notices go out, when unpaid services are suspended and terminated, and whether domain sync runs.
Module Queue
The Module Queue, at Utilities > Module Queue, lists failed module actions, such as a suspension a panel rejected during a cron run. Anything left there means a service and its billing are out of step until you retry or dismiss it.
Auto Release
Auto Release is a built-in module for products with no server or API to provision, such as consulting or manual setups. It still changes service statuses and sends the welcome email automatically, so the order flow behaves like an automated product.
Clients and support
Client area
The client area is the customer-facing portal where clients order, pay invoices, manage services and domains, and open tickets. Its look comes from the system theme, and its order pages come from the order form template.
Admin area
The admin area is the staff portal for running WHMCS. It uses the Blend template by default, and WHMCS 9.1 added a preview of a new admin template called Iris. What each staff member can see and do is set by administrator roles at Configuration > System Settings > Administrator Roles.
Client account and user
Since WHMCS 8.0, a client account is the billable party that owns services, invoices and tickets, while a user is a login. One user can access several client accounts, such as a web designer managing each customer's account, and each account has one owner who can invite users and set their permissions.
Custom field
A custom field collects extra information about clients, products or support departments, either admin-only or visible to clients. Client fields are created at Configuration > System Settings > Custom Fields and product fields on each product's Custom Fields tab. Some provisioning modules require specific product fields.
Ticket department
A ticket department, called a support department in WHMCS, sorts tickets by topic, such as Sales, Support or Billing. Each one has its own email address, assigned admins and an optional clients-only setting, configured at Configuration > System Settings > Support Departments.
Email piping and email importing
Email piping and email importing turn incoming emails into tickets and ticket replies. Piping passes mail to WHMCS's pipe.php script and suits cPanel servers importing from one domain; importing collects mail from a mailbox, works with other mail hosts and is the only option on WHMCS Cloud.
Email template
An email template is one of the messages WHMCS sends, from welcome emails to overdue notices, edited at Configuration > System Settings > Email Templates. Templates use Smarty merge fields such as {$client_name}, can be disabled individually, and since 9.0 can't use the removed {php} and {fetch} tags.
Security
API credential
An API credential is an identifier and secret pair that lets an external system call the WHMCS API. Credentials are created at Configuration > System Settings > Manage API Credentials and assigned API roles that allow only specific actions, so a reporting tool can read invoices without being able to create orders.
Two-factor authentication
Two-factor authentication (2FA) adds a second login step for admins and clients. WHMCS supports Time-Based Tokens (on by default), Duo Security and YubiKey at Configuration > System Settings > Two Factor Authentication, and can force users to enroll at their next login. Our WHMCS security hardening guide covers enforcing it.
Encryption hash
The encryption hash is the cc_encryption_hash value in configuration.php, a random 64-character string WHMCS uses to encrypt stored data such as card details. If it's lost, WHMCS can't decrypt that data, so back it up separately from the database.
Tokenization
Tokenization means the payment gateway stores the card details and WHMCS keeps only a token, which reduces your security burden and liability. A token works only with the gateway that issued it, so a Stripe card can't pay an invoice through Authorize.net.
Fraud module
A fraud module checks new orders against a fraud-scoring service before you accept them. WHMCS supports FraudLabs Pro, which it recommends, and MaxMind at Configuration > System Settings > Fraud Protection. For identity checks beyond scoring, see our KYC and anti-fraud playbook.
Development
Hook
A hook is custom PHP that runs when an event happens in WHMCS, such as an invoice being paid, a client registering or an email about to send. Hook files go in /includes/hooks/ or inside a module, and some hook points can return values that change default behavior (hooks guide).
Theme
A theme, or system theme, controls the look of the client area and is built from Smarty templates. WHMCS ships Twenty-One, the recommended theme, and Six, a legacy theme WHMCS plans to remove, selectable on the General tab of General Settings. WHMCS publishes its themes on GitHub as a base for custom ones.
Order form template
An order form template sets the look of the shopping cart. WHMCS ships Standard Cart (the default), Nexus Cart (a dynamic cart added in 9.0), three comparison layouts and two sliders. You can set one per product group, but the View Cart and Checkout steps always use the system default.
Language override
A language override changes WHMCS wording without editing the core language files, so the change survives upgrades. Create /lang/overrides/english.php and redefine only the strings you need, for example $_LANG['cartproductaddons'] = "Product Extras";. WHMCS Cloud uses the Translation Editor addon instead.
Encoded file (ionCube)
An encoded file is PHP protected with ionCube so its source can't be read, and the ionCube Loader PHP extension is needed to run it. WHMCS itself requires ionCube Loader, version 15.0.0 for WHMCS 9.1. Many commercial modules are encoded too, and several WHMCSPilot modules also come with an Open Source license that includes full source.
Frequently asked questions
What is the difference between an addon module and a provisioning module?
A provisioning module is attached to a product and creates, suspends and terminates each client's service on a remote system. An addon module isn't tied to any product; it adds features such as admin pages, reports or client area tools across the whole installation.
Is a server module the same as a provisioning module?
Yes. WHMCS's developer documentation says provisioning modules are also called product or server modules, and both terms refer to code in /modules/servers/.
Should I use a configurable option or a product addon?
Use a configurable option when the choice changes the product's own price and specification, such as RAM or connection count. Use a product addon when the extra is a separate item with its own billing line, such as backups or a dedicated IP.
What is the difference between MarketConnect and the WHMCS Marketplace?
MarketConnect is a WHMCS feature for reselling services such as SSL certificates and website builders, paid from a prepaid balance. The Marketplace is the directory where developers list third-party WHMCS add-ons, and its account holds the MarketConnect balance.
Need a module that doesn't exist yet? Our custom WHMCS module development service builds provisioning, registrar, addon and gateway modules, and the module catalog lists the ones ready to install.