Loyola Support Documentation

How do I format my file for importing grades into Gradebook?

Updated Dec 09, 2020

Instructors can manage grades offline in a spreadsheet and then import the file to update the course Gradebook. You can also import a file as a method for quickly creating several Gradebook items at once.

The easiest way to obtain a file in the proper import format is to export your Gradebook and use that file as a template. This way it will contain all of the student information in your site, as well as any existing Gradebook item information in your site.

Note: You can only update graded items that have been created within the Gradebook. Graded items that come from other tools, such as Assignments or Tests & Quizzes, cannot be updated via file import.

Go to Gradebook.

Select Gradebook from your site's Tool Menu

In the target Sakai site, select the Gradebook tool from the Tool Menu.

Select Import/Export.

Select Import/Export

Select Import/Export from the actions menu.

Select Export Gradebook.

Select the Export Gradebook button.

The export will download as a .csv file.

File appears in downloads folder

The file will download in your browser as a .csv file.

Open the file in your preferred spreadsheet application.

Open the file in your preferred spreadsheet application, such as Microsoft Excel.

Add columns, grades, and/or feedback as needed, and save your file.

The import file must be in .csv file format. Also, be sure to use the following conventions:

  1. Student ID and Student Name are the first two columns and must be retained for any future imports.
  2. Gradebook Items/Assignments may include points by wrapping the points in [ ] after the title (e.g., Assignment 1 [50]).
  3. Comments can be imported by prefixing the column with a * (e.g., * Assignment 1).
  4. Columns that cannot be re-imported are prefixed with #.

Note: You may add new items to the gradebook by including new columns in your file. If you add any new columns without a point value in brackets, Sakai will prompt you to indicate the number of points upon import.

Return to Gradebook > Import/Export to browse for and select your import file.

Select the Browse button to select your .csv file for import.

Choose the file and select Continue.

Choose the file and select Continue

After choosing the .csv file from your computer, the file name will appear to the right of the Browse button (highlighted for emphasis). Select Continue.

For more information on importing your items into Gradebook, see How do I import grades into Gradebook?

Previous Article How do I exclude a grade for a specific student?
Next Article How do I import grades into Gradebook?