Manually Add Users to the CMS

Product: CMS

Version: CMS 8, 8.x

Published: May 9, 2011

Last updated: 1/30/2021



Users can be manually added to the CMS by manually modifying the users.xml file. This is common after a new installation when no user accounts have been created.


  1. Full access to the CMS site directory, located in :\igxsites\.
  2. Ability to stop and start the CMS site's application pool.


  1. Stop the CMS site application pool.
  2. Locate and open :\igxsites\\xml\users.xml in a text editor such as Notepad++.
  3. Locate the node before the node.
  4. Within the node add the following code, replacing the yellow highlighted sections with the relevant information.
    User add user xml
  5. Within the node, locate the node to which you want to add the newly created user.  
  6. After the group is located, add the following code within the node, replacing the highlighted code with the UserID created on step four:
      • domain\newAccountName"/>
      • Example:
    Manual Users
  7. Save users.xml.
  8. Start the CMS site's application pool.
  9. Log into the CMS client using the newly created account.

Additional Information

If a userdomain value is defined in the :\igxsites\\local-appsettings.config, the manually created account(s) must include the same domain within the new account's UserID attribute.


If the local-appsettings.config looked like this:

Local app domain

The newly added user must have the Ingeniux domain prior to the account name in the UserID attribute: 

ingeniux\newAccountName" Email=""/>


There are no comments yet.