Add an Admin

Admins can log in to the Admin Area and perform actions according to their set permissions. For the best results, each member of your staff who will use or view the WHMCS Admin Area should have their own admin account.

You can create as many admins as you want and assign them as few or as many permissions as they need. Some admins may only need to view reports or a single support department, while others will perform sensitive tasks like configuring your WHMCS installation.

Add an Admin

To create a new admin:

1. Create a new admin.

Go to Configuration () > System Settings > Administrator Users or Configuration () > Manage Admins.

The list of admins at Configuration > Manage Admins

Click Add New Administrator.

Adding a new admin at Configuration > Manage Admins

2. Choose an administrator role.

Select an administrator role.

Selecting an administrator role for a new admin
For steps to create or edit an administrator role, see Add or Edit a Role.

3. Enter the admin’s basic information.

Enter the admin’s first name, last name, and email address.

Entering the name and email address for a new admin

4. Set the admin’s credentials or send an invite.

We added admin invitations in WHMCS 8.12. In WHMCS 8.11 and earlier, you must set admin credentials manually.

You can set the admin’s username and password manually or you can send an invitation.

Selecting whether to send an invitation for a new admin
Send an invitation.

Sending an invitation allows the admin to set their own credentials. This helps to improve admin account security.

To send an invitation, set Send Invite to Send Invite Link.

If you only want the new admin to set their own password, you can enter a username. Otherwise, the new admin will be able to select their own username and password.

Set credentials manually.

To set the admin’s credentials manually:

  1. In WHMCS 8.12 and later, set Send Invite to Set Credentials Manually.
  2. Enter the desired username and enter and confirm a password.
Entering admin credentials manually
  • Usernames must:
    • Begin with a letter (AZ or az).
    • Contain only alphanumeric characters.
    • Not include spaces or other special characters.
  • Passwords cannot use the following characters: &, ", ', <, or >.

5. Select support departments.

Select one or more support departments.

Selecting the new admin's support departments

Optionally, if you want the new admin to receive notifications for the departments you selected, check Enable Ticket Notifications for the desired departments.

  • The admin can only view and respond to tickets in the departments that you assign.
  • If you assign the admin to a role that includes Access All Tickets Directly, they can access other departments through direct links.
The most common cause of issues accessing a support department is forgetting to select the desired departments in the admin’s settings. Make sure you select all of the support departments that you want this admin to view or work with.

6. Add a signature and notes.

Optionally, add an admin signature or notes. The notes that you enter are visible to the admin and to all other admins with the Full Administrator role.

The admin signature and notes for a new admin
For more information, see Replying to Tickets and My Notes.

7. Select a template and language.

Select an Admin Area template and the admin’s desired language.

The Admin Area template and language for a new admin

8. Disable the admin.

Optionally, you can check Disable to disable the admin account and prevent future logins.

The option to disable the new admin

9. Save.

When you are finished, click Send Invite (if you set Send Invite to Send Invite Link) or Create Admin (if you set Send Invite to Set Credentials Manually).

In WHMCS 8.11 and earlier, click Save Changes.

If you sent an invite, the admin will appear in the Pending Invites list until they successfully log in. You can cancel a pending invitation at any time by clicking the Delete icon.

The list of pending admin invitations at Configuration > Manage Admins
For more information, see Admins and Accept an Admin Invitation.

Last modified: December 4, 2024