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.

You can import up to 1,000 users at a time in CSV files that are up to 300 KB in size.

To import users:

  1. Create a CSV file containing information about the users you want to import.

  2. When creating a CSV file, use these guidelines:

    User1,pwd

    User2,pwd,,firstname,,lastname,true,,,User 2 description,true

  1. 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:

When creating importfieldspecification.xml, use these guidelines:

  1. 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.

  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.

  1. Go to the import users page.

  2. On the import users page, click Browse next to the user information files text box to locate the CSV file.

  3. Optional: Click Browse next to the import field specification file text box to locate importfieldspecification.xml.

  4. Click Add. The user information is imported, and the accounts are created.

  5. 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.