Importing Users

The User Import functionality within the Admin Interface provides an easy way for you to add and update your Users in bulk.  This article details the standard User Import tool available in the Absorb Admin Interface. If you're looking for information on historical or scheduled data import services, please see our Data Imports article. 

  • For more information on .csv files, see What Is A CSV File.... It covers how to save a CSV file for importing Users, and what a CSV is.
  • Important: The User Import ignores the first row of the .csv file and shifts the lines forward/up one row. This is important for lining up information in error messages that call out specific line numbers/items.

Import Batching

Absorb takes performance seriously, so we group large volumes of changes together and process them at 10 minute intervals more efficiently than one at a time. This has the potential to introduce a short delay before you see the results, but ensures that your portal is more responsive to one-off Admin actions and Learner activities.


Creating a CSV File

Before upload, remember to add a single row at the beginning of the table to ensure you are looking at the correct User data. This will be useful in the event that any error messaging is returned when uploading the file.

  • The First Name, Last Name, and Password columns are required for new User Import (the Password column can be removed if you are updating existing Users).
  • The order of the columns is irrelevant and can be changed/altered, without affecting the validity of the import file.
  • While the Email Address and Gender fields are not required to import Users, if your .csv file has columns for these fields, the system will perform a formatting check on the cells in these columns, which blank values will fail. As such, you may need to split your CSV into multiple files if you have some Learners with values for these fields, and others without.
  • When the Update Existing Users option is enabled (toggled ON), new Users can be included, but First Name, Last Name and Password will be required for the whole file. Blank values for First Name and Last Name will overwrite current values for existing Users, however the Password field can't be overwritten via a User Import, and can be left blank.


Please note that the upload will not check for data integrity (for example, if an Email Address is a valid Email Address, please review your data carefully).


Available Fields

The following fields are available to be imported via the Admin Interface are:

  • Status
  • Username
  • Middle Name
  • Gender
  • Language (for a full list of Absorb's Language codes click here)
  • Address
  • Address2
  • City
  • State/Province (if this in your CSV file, Country must also be present)
  • Country
  • Zip/Postal Code
  • Phone
  • Employee Number
  • Location
  • Job Title
  • Notes
  • Email
  • Date Hired
  • Termination Date
  • External ID
  • Custom Fields


Absorb Country and State/Province Codes

The attached document at the bottom of this article contains a list of both acceptable Country code values and State/Province code values. These codes mirror the ISO 3166-2 list of standardized values for these attributes.

When importing Users, the only supported date format is YYYY-MM-DD. Please note that using any other format is not currently supported, and we cannot guarantee that the User Import will complete successfully.


Unavailable Fields

The following fields cannot be included in the Import:

  • Supervisor
  • Avatar
  • CC Email Addresses

The Supervisor, Avatar, and CC Email Addresses must be updated manually through the Users Report


Additional Fields / Settings

Additional Fields are available during the import process. The difference between the information you provide in the .csv and the Additional Fields is that additional fields will be the same for all users in the import.

The available additional fields are:

  • Department
  • Roles
  • Learner
  • Admin
  • Instructor
  • Language
  • Country
  • Province
  • City
  • Location
  • Job Title
  • Date Hired
  • Date Terminated
  • Notes
  • All Custom Fields


Uploading a CSV File 

  1. Navigate to the Users Report and select the User Import button from the top or side barUSERIMPORT2.png
  2. Select the .csv file you created from the File Manager or upload a new one.import2.png


Mapping the User Fields

Once you have successfully uploaded your file, you will be presented with several options that will determine how the imported data will be used.

  1. Select the Username format using the LMS Username drop down menu. You can choose from any of the fields that are included in your CSV (ie. like Email Address, or by combining the FirstName.LastName entries together)
    • For consistency, be sure to format Usernames the same as existing Users.
    • It is not possible to update the LMS Username via the Import


  2. Choose whether you wish to Update Existing Users that already exist in your LMS with the imported data. Enabling Update Existing Users will update/replace data in existing Users. If not enabled, all data will be imported as new Users. Proceed with caution here.
  3. If Updating Existing Users, match the Link Spreadsheet Field with the fields available in the to LMS Field drop down.


  4. Enabling Send New User Email will email your portal's New User Message Template to all the new Users that are being created by the import. Updated Users will be omitted.
  5. Next, you will see the Source Data Preview. This will show you the top 5 records in your document to aid in selecting the appropriate Absorb field to map to.  The LMS will attempt to intuitively auto-match your column headers with Absorb fields, but this can be manipulated using the drop-down menu below each header. Review each column and the mapped Absorb field, add and alter as necessary.



Additional Data 

Below the Source Data Preview section, you'll find an expandable Additional Data section. This area allows you to specify additional data that will apply to all Users being imported.

  1. Check off the fields that you want to include in the import.
  2. Select or enter the relevant data.

Import User Status

You are able to select if Users import as Active or Inactive. The Inactive Status is useful if you want to import the Users ahead of time or have additional setup to do before allowing them access to the LMS. The imported Users will not be able to log in to the LMS unless their Status is Active.


  • Imports can only include one Department at a time. If you wish to import multiple Users into various Departments you will have to split the imports up into their respective Department and select it in the Additional Details. You can also change the Department after the Users are uploaded.
  • If you have a Blended Billing Model, a tool tip will state whether the Department you've selected has Internal or External Billing applied. Please ensure you have selected the correct Department and the Department has the expected Billing Type.




Once the Mapping and Additional Data has been reviewed and confirm, select the Validate button. During validation any data conflicts will be shown as errors (including the row number). The data will need to be corrected by altering the .csv file or by adjusting the mappings.  If no conflicts are found, you'll be shown the total amount of Users that will be created and updated. Click on Load once you are ready to have all Users added to your portal.  


Was this article helpful?
12 out of 17 found this helpful



Article is closed for comments.