Gradebook: Importing an Excel (CSV) File Moodle ISU


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

If you would rather calculate your grades in Excel and import them into Moodle ISU, it is advisable that you first export a blank gradebook from Moodle ISU, so your spreadsheet will import easily.

  1. In the Administration block, Select Grades.

Administration Block - Grades.jpg

  1. In the Administration block, Select Export.


  1. Select Excel spreadsheet.

Excel Spreadsheet.jpg

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: You can also Click Select all/none to select all categories to be exported.

  1. Click Download.


  1. In the pop-up window that appears, Select Save File.
  2. Click OK.

Save File.jpg

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

Note: Remember to input your grades into this saved version so that your grades will be up to date when you import.

Save Your Excel File as a .CSV File

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

  1. Open the Excel file you would like to import into Moodle.
  2. Click Enable Editing, if needed.
  3. In the right hand corner of the Excel document, Click File.


  1. Click Save As.

save as.jpg

  1. Choose where on your computer you would like to save the file.
  1. Locate the Save as type dropdown menu.

Save as CSV.jpg

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

  1. Select CSV (Comma delimited)(*.csv).
  2. Click Save.
  3. When asked if you want to keep the workbook in this format, Click Yes.

Click Yes.jpg

Import File into Moodle ISU

  1. In the Administration block, Click Grades.

Administration Block - Grades.jpg

  1. In the Administration block, Select Import.


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

Grader report menu.jpg

  1. Click CSV file.

Select CSV File.jpg

  1. Click Choose a file.
  1. You can also drag and drop the file into the boxed area.

Choose a File.jpg

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

File Picker.jpg

  1. Click Browse.
  2. Select the file that you wish to upload from your computer.  
  3. Click Open.
  1. Once you have selected the file, it will automatically appear in the Attachment text box in the File picker.
  1. 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.
  2. Click Upload grades.

Upload Grades.jpg

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:
  1. Scroll down to the Identify user by section.
  2. Select from the following options:
  1. Map from ID number: The Excel file will match with the ID number that you have for a specific student.
  2. Map to ID number: Refers to the student's’ ID number.

Identify User By.jpg

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. Locate the Grade item mappings section.
  2. From the dropdown menu, Select one of the following for each of the columns you are importing:
  1. Ignore: If you would like to set no mappings at this time.
  2. New grade item: If a grade item does not exist in the Moodle ISU Gradebook.
  3. To map a grade item, you will need to match up the name of the item in the gradebook with the name of the column in the import file. For example: Quiz: Quiz Sample
  4. To map feedback for a grade item, you will need to match up the feedback field in the gradebook with the feedback column in the import file. For example: Feedback for Quiz: Quiz

Note: You should not map any of the fields that contain student identifying information such as name or email.

  1. Click Upload grades to continue.

Upload grades.jpg

  1. Once the grades have been imported successfully, Click Continue.
  2. 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.

For more information, see Grade Import

For additional information, contact the ITRC - (208) 282-5880 or email

This work was done by Instructional Technology Resource Center at Idaho State University and is licensed under the Creative Commons Unported License. To view a copy of this license, visit Attribution Noncommercial 3.0 United States or send a letter to Creative Commons, 444 Castro Street, Suite 900, Mountain View, California, 94041, USA.