On the top navigation bar, click users, then click import users on the action bar above the users list.
Importing multiple users
If you need to add multiple user accounts, you can place the user information in a CSV (comma-separated value) file and import the users in bulk using that file. Importing users is an alternative to using the add user account wizard, which allows you to add only one user at a time.
While importing multiple users, all these users will inherit the settings for the password expiration feature from the organization.
You can import up to 1,000 users at a time in CSV files that are up to 300 KB in size.
If you need to import more than one CSV file or more than 1,000 users to a single organization, wait until each import action is complete before starting a new one. Do not run multiple import actions for the same organization at the same time.
To import users:
Create a CSV file containing information about the users you want to import.
When creating a CSV file, use these guidelines:
Place user information on a single line; a new line indicates a new user.
Use a comma to separate each value. There are 12 values, most of which are optional.
If you do not want to supply an optional value, you still need to type a comma for that value unless it is the last value you are entering. This is shown in the following example. User1 is added with only two values, so only one comma is required. User2, however, has skipped values. Commas representing the skipped values are required.
User1,pwd
User2,pwd,,firstname,,lastname,true,,,User 2 description,true
If you want to enable services for users, provide the name of a valid user template in the template value of the CSV file. This template name is the third value specified. If you do not specify a template, the account is created without access to services. If you want to enable services later, you need to change each account individually.
If the system detects an error in a user's information, that user is skipped. Information about the error is provided in the Action Log.
Keep your CSV file within these limits: the maximum number of users you can add at once is 1,000; the maximum size of the CSV file is 300 KB.
Save the CSV file with a .txt extension and UTF-8 encoding, if you want to import the users in a particular language other than the default English (U.S.). You should have the language pack available in your control panel before you import users in that language. You can save the CSV file with a .csv extension if you are importing users in the default English (U.S.) language.
Optional: Create an importfieldspecification.xml file containing the configurable information about the users you want to import. This configurable information can include the generic information and/or the service-specific information.
For some organization services, you can dynamically change the values of the service-specific options defined in the user template by specifying the new values in the CSV file. Currently the following services support this feature:
BroadWorks
You can use this feature only if your organization is provisioned with one of the services mentioned above.
When creating importfieldspecification.xml, use these guidelines:
Make sure that importfieldspecification.xml maps a particular column in the CSV file to the value of a generic or a service-specific option for the users.
While creating importfieldspecification.xml, ensure that you specify the exact name of the generic or service-specific options in the same case as mentioned in the above links; otherwise the import process fails with an error.
While defining importfieldspecification.xml, do not use column numbers 1 to 12 since they are already used for defining the general settings of a user.
You can also use the same importfieldspecification.xml to provision more than one service that allow you to dynamically change the values of the service-specific options. To do this, in importfieldspecification.xml, you need to define the first set of column numbers after column number 12 to map the generic options. You can then define the next set of column numbers to map the service-specific options for one service, and the next set of column numbers to map the service-specific options for another service.
Optional: Update the CSV file to specify the values of the generic or service-specific options that you have defined in importfieldspecification.xml in step 2.
While specifying the values of these generic or service-specific options for users in the CSV file, ensure that each value belongs to the specified type such as an integer or a string; otherwise the import process fails with an error. Refer to the above links for determining the type of its options.
Go to the import users page.
On the import users page, click Browse next to the user information files text box to locate the CSV file.
Optional: Click Browse next to the import field specification file text box to locate importfieldspecification.xml.
Click Add. The user information is imported, and the accounts are created.
Since this operation may take a long time, you can browse through other GUI pages in the control panel while the import users operation is in progress. To check the status of the operation, you can check the action log.
If errors are reported, check the Action Log. It shows information about the error, including the users affected. If the system encounters an error in the CVS file, it skips the current user and attempts to add the next user in the file.
The users you successfully imported appear on the users page. Email messages welcoming the new users are sent to the email addresses provided for the users. These email messages are based on your organization's site's email templates.