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. Locate the Administration block.
  2. Click on the Grades option.

  1. Click on the Export option.

  1. Click on the Excel Spreadsheet option.

  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 on the Submit button.

  1. In the pop-up window that appears, Click on the Download button.

  1. In the box that appears, Click the OK button to open the blank Gradebook. The blank Gradebook should open automatically for you.
  2. Remember to 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

  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.
  3. Click on the Save As option.

Note: A new window will appear to give you options for saving your Excel sheet.

  1. Locate the Save as type dropdown menu.

Note: The Save As Type dropdown menu is located below the file name dropdown menu and is the second dropdown menu under the Documents Library box.

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

Importing a CSV File into Moodle ISU Gradebook

  1. In the Administration block, Click on the Grades option.

  1. Click on the Import option.  You can also Select the Import tab at the top of the page to go to the import page.

importing grades.jpg

  1. Click on the CSV File option.

  1. Click on the Choose a File…button located on the main work screen. You can also drag and drop the file into the boxed area.

importing file.jpg

  1. A new window will open called the File Picker.

  1. Click on the Upload a File option.
  2. Click on the Browse button.
  3. Double Click the file that you wish to upload from your computer.  Once you have selected the file it will automatically appear in the Attachment text box on the File Picker screen.
  4. Click on the Upload This File button 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…button.

  1. Do not change any of the other available options on the screen.
  2. Click on the Upload Grades button.

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 locate the Identify User By section.
  2. 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 student’s 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 the Upload grades button to continue.

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

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.