critical_error

Registered
Jan 30, 2012
4
0
51
cPanel Access Level
Reseller Owner
Hi,

I want to create a username based on a user's domain on my own and couldn't find out what the exact rules for a cPanel username are.
I know it can be max. 8 chars long, but which characters are not allowed and will be ignored by cpanel?

Thank you!
 

cPanelDavidG

Technical Product Specialist
Nov 29, 2006
11,212
13
313
Houston, TX
cPanel Access Level
Root Administrator
Hi,

I want to create a username based on a user's domain on my own and couldn't find out what the exact rules for a cPanel username are.
I know it can be max. 8 chars long, but which characters are not allowed and will be ignored by cpanel?

Thank you!
The short answer is: cPanel usernames are also the usernames of system users, so if it's a valid system username then it would very likely be a valid cPanel username. There are some notable exceptions like "root" and "test" but they are exceptionally rare. Our APIs will return if an account creation failed and why, if you use the APIs.
 

cPanelTristan

Quality Assurance Analyst
Staff member
Oct 2, 2010
7,607
41
348
somewhere over the rainbow
cPanel Access Level
Root Administrator
The rules that I know for cPanel usernames are the following:

- Only alphanumeric characters are accepted (space, dash, underscore, etc. are not allowed)
- Must be 1-8 characters long (other than account transfers from non-cPanel machines that support longer than 8 character usernames)
- Cannot have the password as part of the username
- Cannot start with test
- Cannot start with a digit
- Cannot use an existing user on the system such as root (reserved usernames)