Import Gradebook from an Excel (CSV) File [Faculty]


There are a variety of reasons that you may want to import a file into your Moodle ISU gradebook.  For example, it might be easier to input and track your grades in Excel, you may need to include grades from an external system in your Moodle ISU gradebook, or you may need to move grades from one course (such as a lab section) to another.

This Guide Will Help You to:

  • Export a Blank Gradebook Template from Moodle ISU

  • Save the Excel File as a .CSV File

  • Import File into Moodle ISU

  • Seek further assistance

Export a blank gradebook template from Moodle ISU

Exporting a blank gradebook template will allow you to calculate grades in Excel before importing them back into Moodle ISU.

  1. In the upper left hand corner, expand the Navigation drawer (the white icon with three black horizontal lines), click Grades

  2. In the top right hand corner expand the Grader report dropdown menu, scroll down nearly to the bottom and select the Excel spreadsheet export option


[Note: You can also access the Import option from the Grader report dropdown menu.]

  1. In the Grade items to be included section, you can select or deselect the items to be included in the export

[Note: At the end of the section, You can also click Select all/none to select all categories to be exported.]

  1. Click Download

  2. In the pop-up window that appears, select Save File

  3. Click OK

  4. Save your file to a location you will remember so that it will be easier to find

Save your Excel file as a .csv file

Saving the file as a .csv allows the data to be saved in a table structure format. The file must be saved as a .csv in order for grades to correctly import into Moodle ISU.

  1. Open the Excel file you would like to import into Moodle

  2. Click Enable Editing, if needed

  3. In the left hand corner of the Excel document, click File

  4. Click Save as

  5. Choose where on your computer you would like to save the file

  6. Locate the Save as type dropdown menu


[Note: The Save as type dropdown menu is located below the File name dropdown menu.]

  1. Select CSV (Comma delimited)(*.csv) and click Save

  2. When asked if you want to keep the workbook in this format, click Yes


Import file into Moodle ISU

  1. In the upper left hand corner expand the Navigation drawer (the white icon with three black horizontal lines), click Grades


  1. In the top right hand corner expand the Grader report dropdown menu, scroll down nearly to the bottom and select Select CSV file under Import


  1. Click CSV file

  2. Click Choose a file

    • You can also drag and drop the file into the boxed area

[Note: A new window will open called the File picker.]

  1. Click Browse

  2. Select the file that you wish to upload from your computer  

  3. Click Open

    • Once you have selected the file, it will automatically appear in the Attachment text box in the File picker

  4. Click Upload this file located as the last option in work screen area

[Note: You will be taken back to the Moodle ISU work screen. The file you have selected will be shown under the Choose a file.]

  1. Do not change any of the other available options on the screen. The defaults are:

    • Encoding is set to UTF-8

    • Separator is set to Comma

    • Verbose scales is set to yes

    • Previous rows is set to 10

    • Force import is unchecked, however you can select this option if you updated the grades after the import file was exported

  2. Make sure the Encoding option is UTF-8

  3. Click Upload grades

  4. ""

[Note: You will be taken to a preview of the file you are about to upload.  This is to help you match up the scores with the information in Moodle ISU.]

  1. If you first exported a blank spreadsheet:

    • Scroll down to the Identify user by section

    • Select from the following options:

      • Map from: The Excel file will match with the selection you choose from the drop down menu

      • Map to: This must match the selection you made in the Map from section

[Note: If you created your own spreadsheet, you will need to choose which two columns to map the information.  If there are any typos, name changes, or other inexact matching, the students’ scores will not come in correctly or could potentially be placed in the wrong sections. We strongly advise exporting first from Moodle ISU.]

  1. In the Grade item mappings section you will select which grade items will be pulled into Moodle.  Your spreadsheet items are listed on the left with the items in Moodle ISU in the dropdown menu

  2. From the dropdown menu, select one of the following for each of the columns you are importing:

    • Ignore: If you do not want to pull that item from your spreadsheet into Moodle ISU

    • New grade item: If a grade item does not currently exist in the Moodle ISU Gradebook

    • Select a specific item under the Grade items list in the dropdown menu to put the grades in your spreadsheet into the selected column in Moodle ISU. For example: Quiz (spreadsheet list) - Quiz Sample (dropdown menu list)

    • Select a specific item under the Feedbacks list in the dropdown menu to pull the feedback from your spreadsheet into the selected column in Moodle ISU. For example: Feedback on Assignment 3 (spreadsheet list) - Feedback for Assignment 3 (dropdown menu list)

[Note: Do not map any of the fields that contain student identifying information such as name or email.]

  1. Click Upload grades to continue

  2. Once the grades have been imported successfully, click Continue

  3. You will be taken back to the Grader report. Any new grade items created will be added to the end of your Moodle ISU Gradebook

Seek Further Assistance

For additional assistance please contact, ITRC at (208) 282 5880 or

For more information please visit, Grade Import


Creative Commons License
This work was created by the Idaho State University Instructional Technology Resource Center and is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License


Article ID: 54535
Fri 5/25/18 1:15 PM
Tue 6/23/20 1:01 PM