View Categories

How to Bulk Import Users via Excel Template

Article verified for Release 12.5 on September 16, 2024.

This article explains how to create hundreds of user accounts at once using our import users’ data with an Excel template.

Import users from an Excel file #

To upload users, do the following:

  1. Hover over the Users tab in the main menu.
  2. Select theĀ  User profilesĀ tab.
  3. Click on the Load usersĀ button.
  4. Click on the text Excel template to download a predefined Excel template. Filling in the Excel template according to the set rules is necessary to import the data successfully. Please refer to the heading below to learn more about how to complete the template.Ā 
  5. Click on the hyperlink to download the instructions for filling in the template for uploading.Ā 
  6. When you fill in the template, add a file with user data by clicking the Select File button.
  7. Click the Upload button to load users into the YouTestMe GetCertified.

    Filling in the Excel template #

    The Excel template consists of a sheet containing fields where users’ personal and account information should be entered.

    The first seven columns are mandatory to fill in: username, password, codes denoting the user’s role and status, first and last name, and email address.

    Gender, date of birth, affiliation within the organization, groups, country, and city are optional fields for bulk import.

    Those fields can be requested to be filled by the users themselves.

    The second sheet contains Legend. It provides explanations and instructions for filling the fields that require predefined codes, specifically:

    1. User roles in the system – There are four default roles: administrator, student, instructor, and proctor. However, new, custom roles can be created, and the system would generate codes upon them.
    2. Status – The status of a user account can be active, suspended, locked, inactive, or pending. As shown, explanations and codes can be found in Legend.
    3. Gender – Insert a code denoting the user’s gender.
    4. User groups – Each user group in the system has its ID. To add a user to the user group when uploading them as an Excel file, enter a user group ID found in the Information tab of the corresponding group.Ā Ā 
    5. Custom columns – Custom columns that have the value text, date, timestamp, number, and dropdown can be added to the user’s personal information.

    The Excel sheet also has a column for adding custom properties. You can add as many as needed. For more information on how to use and create custom properties, please visit this link.

    When the Excel file is uploaded, you can see imported users by filtering the users by Creation date in descending order.

    Assigning users as group managers from the Excel template #

    In theĀ Groups managerĀ column, insert the group ID where the newly created user will be automatically added as a manager or member.

    For example, we have created a user, admin01 that we set as a group manager with the ID 1543.

    After uploading the Excel template, navigate to the User groups tab and search for the ID set in the template. Then, click the Managers tab to view all the managers in the selected group.

    Powered by BetterDocs

    function year_shortcode() { $year = date('Y'); return $year; } add_shortcode('year', 'year_shortcode');