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.

Admin block.jpg

  1. From the Administration block, Select Export.


  1. Select Excel spreadsheet.


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

Grade items.jpg

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 on the File tab located at the top of the tool bar.


  1. Click Save As.

save as.jpg

  1. Choose where on your computer you would like to save the file.
  1. A new window will appear.
  2. Locate the Save as type dropdown menu.

csv file.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.

Incompatible features.jpg

Importing a CSV File into Moodle ISU Gradebook

  1. In the Administration block, Click Grades.

Admin block.jpg

  1. From 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.

CSV File import option.jpg

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

importing 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.


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 and Select from the following options:
  1. Map from ID number: The Excel file will match with the Bengal ID number that you have for a specific student.
  2. Map to ID number: refers to the students Bengal ID number.

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.  ie. Quiz: Quiz Sample
  4. To map comments for a grade item, you will need to match up the comments field in the gradebook with the comments column in the import file.  ie. Comments Quiz:  Comments Quiz Sample

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 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.