If you have a large number of users to create or edit in Litmos, you will want to use our bulk import option. This will enable you to upload a Comma Separated Value (CSV) file containing up to 5000 users, and automatically send out a login email to each one if needed.

To get started, click on the “People” tab in Litmos and then select the “Import people in bulk” option.

Building your CSV file

For the CSV file template, click the “use this template to get started” link.  To edit the CSV file, we recommend using text editor like Notepad or a spreadsheet tool like Excel or Google Sheets.

There are many fields that can be uploaded for each user. The fields 'Username', 'First Name' and 'Last Name' are mandatory and the rest are optional.

**When Team Leaders/Team Admins Perform an Import: **The Team1 Column is mandatory for Team Leaders/Team Admins performing an import since team leaders/team admins can only import to their team(s). Without a team, the import will fail for team leaders/team admins.

Note: When you construct your CSV file be sure to add each new user on a new line.

Note:  For a list of Language codes, see the article, Languages - This is a list of possible culture values.

Once the CSV file has been constructed, upload the file by selecting it and clicking “Next”.  If the field names are listed in the first row of the file then check the “The first row of my file contains column titles” box so the import ignores the first row.

Import people directly into teams

The optional Team1, Team2, Team3, Team4 and Team5 columns make it possible to import people directly into teams.

First, create the Teams in Litmos. Second, retrieve each team's unique import code from each team's settings tab. Third, enter this code into one of the Team1-Team5 columns of your CSV file.

Assign people to Courses

The optional Course1, Course2, and Course3 columns make it possible to assign multiple courses to a person.

1. Create the Course in Litmos.
2. Retrieve each course's unique import course code from each course's settings tab. (This also can be found in the Course Quick report)
3. Enter this code into one of the Course1 - Course3 columns of your CSV file.

Importing Advanced User Custom Fields

Advanced user custom fields can be included in the People Bulk Import if the feature is enabled on the account. In this case, additional help information will appear on the import people page in the system, including an ability to view the advanced custom field details.

There are important aspects of advanced custom fields that must be taken into consideration before attempting to import advanced user custom fields:

• The field value for a custom field must comply with the chosen field type, or the import will fail for users without valid values. Please check your organization’s date format and any available drop-down values. An invalid data type or format will result in user import failure. Drop-down text values require matching upper case and lower case sensitivity, but this requirement will soon be eliminated.
• If a custom field provides a default value, and a user in Litmos does not have a value for that field on the user record, the default value will be applied if the field is mapped during the import.
• If a mandatory value is required for a custom field, the custom field value must be entered for each user. A missing value for a mandatory value will result in a user import failure.

Matching the Data with the Litmos Import Fields

The final step is to map the columns in the file with the fields Litmos needs to create a new user account.  Once the fields have been mapped, click “Import” and your file will be queued for importing.  At this step, login details can be sent to each of the new users by checking the “Send a login emails" box and an email will be sent to each user that is successfully imported.  If the "Skip First Login" box is checked, the users will not be prompted to verify their profile information and reset their password upon their first login.

 Reviewing the Status of the Import

A list of your recent bulk imports and the status of each bulk import is displayed on the right side of the People page.  You can also download a CSV file that contains the import status of each of your new user records.

NOTE:  When importing a CSV containing special characters, such as Chinese, Koran, or Hebrew, reference this article to minimize possible errors.

For Bulk Deactivation of users.

In the bulk upload file, keep all the columns intact and just update Username, FirstName, LastName and FALSE option in the Activate column.