Username allowed chars

[critical_error]

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]

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]

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)