Panellicense

Fix cPanel account creation blocked by the license limit

WHM won't create new accounts and the error mentions your license? You've hit the account cap on your cPanel tier. How to confirm it, count accounts correctly, and clear it.

cPAll cPanel articlesTroubleshooting4 min readUpdated 2026-09-09
cpanelwhmlicensingaccount-limitsprovisioningtroubleshoot
schema: TechArticleschema: FAQPageschema: BreadcrumbList

WHM's Create a New Account fails, or a WHMCS or Blesta order drops to Pending with a "Create Account Failed" module error, and the reason string mentions your license or a maximum number of accounts. This is the account cap on your cPanel tier, not a broken or expired license.

Nothing that already exists is affected — sites serve, mail flows, existing accounts log in normally. Only new account creation is blocked. This article is the decision tree for confirming that and clearing it, aimed at hosts who hit the ceiling mid-growth or mid-migration.

Step 1: confirm it's the cap, not an invalid license

The cap and an invalid license produce different symptoms. You're looking at the cap if:

  • the error text mentions "maximum number of accounts", "license", or "account creation limit"
  • WHM itself loads fine and existing accounts work
  • cpkeyclt reports the license as valid
/usr/local/cpanel/cpkeyclt

A clean "Update succeeded" here plus blocked account creation means you're at the cap. If WHM shows a red License invalid banner instead, that's a different failure — work through the cPanel license invalid checklist.

Step 2: count accounts, not domains

A cPanel account is one user under /var/cpanel/users/. Addon domains, subdomains, and parked domains do not count.

ls -1 /var/cpanel/users | wc -l

Compare that to the domain count and you'll see they diverge — expected, and only the first number matters for licensing:

wc -l < /etc/trueuserdomains

Step 3: match the count to your tier

TierAccount capPrice
Admin Cloud5$35.00/mo
Pro Cloud30$53.00/mo
Premier Cloud / Premier Metal100$69.00/mo

If your account count is at or above the cap for the SKU you're paying for, that's the block. Full breakdown in cPanel license tiers explained.

Fix 1: upgrade the tier

This is the answer most of the time. Upgrade the SKU from your cPanel license dashboard — same key, same server, no reinstall, no migration, no downtime. cPanel picks up the new cap within a minute; force the refresh rather than waiting for cron:

/usr/local/cpanel/cpkeyclt

Then retry the account creation. Billing for the jump is prorated to the cycle — see how prorated license billing works. Past 100 accounts on Premier there's no self-serve tier; contact sales for a fleet quote.

Fix 2: prune dead accounts

If the growth was unintentional — churned clients, abandoned trials, stale staging copies — reclaim the slots. Find candidates:

whmapi1 listaccts | grep -E 'user:|suspended:|domain:'

Back each one up, then terminate it in WHM » Terminate an Account. Terminating is what releases the slot; suspending is not.

Provisioning integrations fail the same way

WHMCS and Blesta both surface the cap as a module error on the create action, with the cPanel reason string attached, and leave the order Pending. After you upgrade the tier, re-run the module's Create action on the existing order — don't make the customer re-order. See Blesta cPanel provisioning setup.

Why can't I create a new account in WHM?+
If the error mentions your license or a maximum account count, you've hit the account cap on your cPanel tier. Existing accounts keep working; only new creation is blocked. Upgrade the tier or terminate unused accounts.
Do suspended cPanel accounts count toward the license limit?+
Yes. Suspension does not release the slot. You have to terminate the account for the count to drop.
Does upgrading my cPanel license require a reinstall or migration?+
No. The tier change applies to the same license key on the same server. Run /usr/local/cpanel/cpkeyclt and the new cap is live in under a minute.
How do I check how many cPanel accounts I'm using?+
Run ls -1 /var/cpanel/users | wc -l over SSH, or open WHM » List Accounts. Count accounts, not domains — addon and parked domains don't consume a slot.
What happens to my sites if I go over the cPanel account limit?+
Nothing. Existing accounts serve traffic and mail normally. cPanel blocks new account creation and shows a warning in WHM until you're back within the tier or you upgrade it.

Next steps

Related articles

All cPanel →All troubleshooting →
troubleshoot
Fix cPanel update failures: upcp exit 256, blockers, locks
The upcp failure email tells you almost nothing. Here is the order to check things — update log, package stage, blockers, disk space, and stale locks.
5 min read
pricing
cPanel license tiers explained: Admin, Pro, Premier
We sell four cPanel license SKUs across three named tiers, each capped at a different account count. Here is what each one actually includes, plus a worked example for tier transitions.
5 min read
how to
WHM Standardized Hooks: automate cPanel events with scripts
WHM Standardized Hooks run a script of yours before or after almost any cPanel event — account creation, password change, SSL install — and let pre-hooks block actions outright.
9 min read
how to
Connect Blesta to cPanel/WHM for automatic account provisioning
Wire the cPanel module in Blesta to a WHM server with a scoped API token so new orders create accounts on their own, complete with package mapping, nameserver swap and suspension hooks.
10 min read
troubleshoot
Clear a frozen or stuck Exim mail queue on cPanel
A decision tree for a cPanel Exim queue that won't drain — tell frozen from deferred, find the compromised account, and clear messages without nuking real mail.
5 min read
troubleshoot
How to fix cPanel license invalid and verification errors
A 5-minute decision tree for the "License invalid" banner in WHM — covers IP changes, blocked outbound 2089, time drift, and the cpkeyclt refresh that fixes most of them.
5 min read
Switch in an afternoon

Switch from your current reseller — free.

We migrate active cPanel, Plesk, LiteSpeed and CloudLinux licenses from any reseller. We prorate the first month so you never pay twice, and your customers see zero downtime during the swap.