Table of Contents

Adding Learners using the File Upload Method

Lyndsay Updated by Lyndsay

File Upload is available for subscribers with 50+ seats

Uploading a file is one of the quickest and easiest ways to add Learners to the dashboard and assign courses and Learning Journeys. However, it is important that your file is prepared correctly. Please read on to find out how to prepare a file and upload it to your EasyLlama Dashboard.

Prefer a video tutorial? We've got you covered! Check it out here: File Upload Video Tutorial

First time uploading? If in doubt, please email, making sure to attach your file. We'll be happy to review your file for potential issues and advise on how to make it work!

Did You Know? File upload may now be used to update Learner data and assign courses and Learning Journeys to existing Learners. Simply follow the same rules for uploading new Learners, making the needed changes to the data or adding the course or Journey. Email and Employee ID are used to match records, so you will not be able to update these, and you should be sure they match what's in the dashboard to prevent adding duplicate records. You do not need to fill in all of the columns when updating your data or assigning courses. First name/last name, email or ID, and the course or updated data are all you need! the rest of the columns may stay blank.
  1. Step One: Prepare your file

First download the file template - it's available for download when you click Add Learner > File Upload.

Tips and Considerations
  • Column headings in your file must match these field names exactly to successfully map your data to the dashboard. For example: "Work email" instead of "Email" may cause emails not to be imported with your records.
  • First and Last Names may not be in one combined column.
  • Keep it simple: avoid special formatting
  • Extra columns that don't map to any EasyLlama fields should be removed to avoid them interfering with the upload.
Required Columns
  • First Name
  • Last Name
  • *Email: Not required, but highly recommended, since this is how notifications are usually sent, and because emails are the best way to match existing records and prevent duplication (Employee ID may also be used for matching, but email will be used first). Email must be unique for a file upload. If several people have the same email address, only one will upload. If someone already exists in the dashboard with the same email, no new record will be created and no new course will be assigned. Conversely, if you upload a file with an already-existing learner with a different email, a duplicate record will be created with the new email.
  • Training Type: It is important to use the correct Training Type Codes to assign training. Training Type codes can be found by going to the Learners tab, clicking "Add Learners" and choosing the File Upload method. See the next section on how to get the Training codes.
    Important: If you do not wish to assign training, enter N/A in this field. Leaving this blank may cause the wrong training to be assigned.
    To assign multiple courses: simply separate them with a comma. Example: harassment-us-supervisor,diversity. Do not make separate columns or additional files for multiple trainings.
    To Assign Learning Journeys: Add a column called Learning Journey and use the Learning Journey code for your selected journey. These will work for your custom Journeys, too! See the next section on where to find the codes you need!
🦙Llama Pro Tip! Want to assign Harassment Prevention based on Region and Role? Just make sure the Region and Role fields are filled out correctly and you can just use harassment as your code! The Learner will be assigned the correct course without the need to use all of the different codes!
How to get the Training Codes/Learning Journey codes
Note: These codes can now be used as training tags when using Okta SCIM provisioning.
  1. Training Type codes and Learning Journey codes can be found by going to the Learners tab, clicking "Add Learners" and choosing the File Upload method.
  2. On the File Upload page under #2 you can click "here" to see the list of Training or Learning Journey codes.
  3. Start typing the name of the course in the search bar to narrow down the list, then scroll down to find the training code. You can click the copy button to the right of each course to copy the code to your clipboard and then paste it in the training type column on your file or in a notepad to save for later!

Optional Columns

These are many optional columns. If the data doesn't need to be in the dashboard, it's best practice not to include it.

  • Middle Name
  • Location (Used for companies with multiple offices)
  • Region: This field can be a little complicated! Region helps designate which Harassment Prevention or HIPAA course an individual should be assigned.
    Simplest: Use one of the Regions available: Australia, California, Canada, Colorado, Connecticut, Delaware, Florida, Illinois, India, Maine, New York, Texas, U.S. Federal, United Kingdom, Washington, or Worldwide.
    You may also use the full name or two-letter abbreviation for any US state. The full country name works for most countries, but it is better to use a region name. For any country that does not have its own region, it's safer to simply use the Worldwide region.
    No matter what you use in this field, the Region will be one of the available regions - you cannot create new regions. for example, if you fill in New Jersey, the region will show as U.S. Federal, since that is the region used for NJ for Harassment Prevention training, since NJ has no specific mandates and doesn't have its own course.
  • Role: You must enter supervisor or non-supervisor - no other values will be accepted. Titles like "Manager" or "Shift Supervisor" should be added to the Title field.
  • ID – Employee ID - can be used for matching records to prevent duplication if no email is present.
  • Title – Learner’s Title
  • Department - Learner's department within your organization.
  • Manager – Name of Learner’s supervisor. (e.g. John Doe)
  • Phone number (e.g. 650-312-1122)

  1. Step Two: Review Your Data

It goes without saying that it's important to review your data before uploading, but here are some things to look for:

  • Spaces - there should be no leading or trailing spaces, that is, no spaces in front of or after any value in your file. These spaces often occur when copy+pasting values from another source. They can be hard to spot if your data is formatted to be centered in your cells.
  • Blank Rows - If you have blank rows you are likely to get <Learner Blank> Errors when you upload. Your file will probably still upload, so if you see these errors, check to see if your data uploaded despite them.
  • Duplicate emails - Only one person per email will upload; others will be discarded as duplicates. Sometimes two family members might share an email, or you may want to upload learners who don't have an email and send their course link to their manager's email. In these cases, leave email blank, and you can manually add it in the dashboard after upload, or you can add these Learners manually.
  • Formatting - we suggest using minimal formatting to avoid upload errors. Formatting in empty cells can cause <Learner Blank Errors>
  • Hidden Rows and Columns - hidden rows and columns have been at the root of many upload mysteries! Be sure you don't have any of these!
  • Multiple tabs - You may only upload one tab. Make sure you remove any additional tabs, to avoid issues.
  1. Step 3: Save Your File
  • Best practice is to save the file as a .csv file before uploading. If available .csv UTF-8 seems to work the best, and usually removes excess formatting for you.
  1. Step 4: Upload your file
    Finally! It's time to upload your file!
    If you are concerned, have questions, or even if it's a very large file, please feel free to send it to for review and upload. Please make sure to attach the file to your email in Excel or .CSV format. It's easier for us to help before you upload than after!
    If you're ready, simply go to the Learners Tab of your dashboard, click "Add Learners," choose "File Upload" and then "Choose File," then click the Upload button and wait to be notified that your Learners were uploaded successfully.
    Got Errors? 504 Timeout errors are common here if the file is large. Learner Blank errors are also common, but often just mean there is a blank space entered somewhere on your file. Your Learners most likely still uploaded correctly, though, so take a look at the Learners tab before troubleshooting or contacting Support!

    If you see another type of error message, please copy and paste it (good) or take a screen capture (best). Then, go to your Learners tab first and see if the upload worked. If it didn't, please send the error code and file to We'll take a look!
  2. Step 5: Review your data
    Take a look at your Learners tab to make sure that everyone uploaded with correct data, and that correct courses were assigned. At this point, unless there is a huge issue, it's best to make manual corrections within the EasyLlama dashboard. Here's how: Edit a Learner's Profile information: Individual and Bulk Updating Learner Details.
    If there is a huge issue and you need help, you guessed it! Send a description of the issue, and your file to!
    If everything looks good, move on to the next step!
  3. Step 6: Send the Notifications!
  • To send the notifications to only some Learners, check the boxes next to their names and then click the "Notify" button
  • To send the notifications to all Learners in your dashboard with an incomplete course, you'll select all Learners before clicking "Notify." For more information on selecting all Learners, please see this article.

That's it! Your Learners have been notified, and you can now track their progress in the dashboard!

How did we do?

Adding Learners to your Dashboard

File Upload Video Tutorial