You are now in the main content area

Export and enter grades in a CSV file

Overview

You can easily save a copy of your students' grades and data by exporting it from your Brightspace shell's 'Grades' tool.

You may want to use this data to have a record of the grades that you can save outside of Brightspace, or even to do additional calculations that you cannot achieve using the features in Brightspace.

*IMPORTANT: to preserve the privacy of your students, please do not share this data with others and please do not email the exported grades (even to yourself).

Export grade items

1. On the Enter Grades page, click Export.

  1. Select All users from the Export Grade Items For drop-down list to export grades for all students. Select a specific section to export grades for select students.
  2. Select the Key Field you want to use to identify users.
  3. Select the Grade Values and User Details you want to export.
  4. Check off Last Name and First Name.
  5. Select the Grade Items you want to export.
  6. You have two export options:

    If you are exporting a file to enter grades and re-import, choose “Export to CSV”. You can still open this file type in Excel to enter grades. The file type must remain a .csv file in order to successfully import back into D2L.

    If you choose “Export to Excel”, please note you cannot use this Excel spreadsheet to re-import back into the D2L Grades tool. We do not recommend using this method if your goal is to work on your grades in a spreadsheet and re-import them. This option is good for saving an archive of your grades to Excel.


8. A pop-up window will appear. Click on your file's link to download it.

Overview

You can enter and calculate your grades in a third-party application, like Excel, and then import them into the D2L Brightspace Grades tool.

Below, we have outlined the process that seems to work best for our instructors.

Importing Scantron data?

You can follow the instructions below to import the data, using your preferred file (D2l-upload.csv or D2L-upload.raw.csv). The one thing you will need to do is name the new column 'GRADE1'. This can be changed after you have imported the grades.

Even before you start grading in Excel (or whichever application you prefer), it is best to create the columns in your course shell in D2L Brightspace.

We also recommend hiding the grade item (column) from all students at this stage, so you can later control when students are able to see their grades (and, subsequently, receive email Notifications).

SCANTRON: If you are importing Scantron data, you must name the column 'GRADE1'.

After creating the grade column(s) in your Brightspace shell, you will need to export the grades to a spreadsheet format that you can work on outside of Brightspace.

Follow the steps outlined in the Export grade items tab of this page.

Once you have exported a spreadsheet file containing the column information from your Brightspace shell, you will need to enter the grades.

*Be sure to match the grades to the students! Double-check the grades before you upload them to your Brightspace shell.

If you are copying and pasting grades from another spreadsheet, make sure the other spreadsheet has the students listed in the same order as the spreadsheet you got from Brightspace. It's worth taking the time to double-check your list before you begin.

Enter grade items in spreadsheet
  1. Once you open the exported CSV file in Excel or another spreadsheet program, you can begin entering grades for each student. For grade data to be imported correctly later, you must enter the points value under the grade item column. For example, if the max points for an assignment is 10, you will enter the number of points the student achieved out of 10.
  2. You can view the number of max points in the title of each column (e.g. <MaxPoints:10>)
 

Creating a grade item/column *during* the import stage

The recommended workflow (as outlined above) is to create all grade items in your Brightspace shell before the import process. We don't recommend the creation of new grade items/columns using the spreadsheet, during the import to Brightspace.

Why?

  • A new grade column created during the import process will be visible to students immediately after the import. This may generate an immediate email notification to the students to let them know that a new grade has been posted. 
  • The heading for a new grade item must follow a very specific naming convention in the spreadsheet. It is very common for people to have mistakes in this heading, therefore creating errors during the import... and generally creating more work for themselves in the long-run.


If you choose to not to follow the recommended workflow, and would prefer to create the new column during the import process, you need to ensure the name of the column follows the necessary naming convention:

Grade Item Name Points Grade <Numeric MaxPoints:10 Weight:10>

You can change "GradeItemName" to the name of your grade item, but you MUST include "Points Grade" after the name or you'll receive an error notification upon importing the file. The MaxPoints and Weight can be adjusted appropriately.


 

Once you've entered grades and saved your CSV file, you can begin the importing process.

Enter grade items in spreadsheet
  1. In your D2L shell, go to the Grades Tool, click the Enter Grades tab, and click Import.
Enter grade items in spreadsheet
  1. Click Browse.
  2. Locate the file you want to import and click Open.
  3. Select Create new grade item when an unrecognized item is referenced if you created new grade items in the CSV file.
  4. Click Continue.
Enter grade items in spreadsheet
  1. If you created new grade items:
    • Select the Create New Grade Item check box beside each of the items you want to create.
    • Select a grade item Type.
    • Click Continue.
    • Fill in the grade items’ properties.
    • Click Continue.

    Note: Creating a new grade item in the CSV file will be active by default in D2L. You will not have the chance to hide them from students before they get a notification about a new grade posted. If you do not want grades going live right away, making them visible to students, it’s recommended that you create the Grade Item first in the Grades tool before importing so you can control the settings (see links above).

Enter grade items in spreadsheet
  1. View error and warning messages associated with the import, and click Continue.

    Note: Fields with errors are not imported.

Enter grade items in spreadsheet
  1. Preview your import and click Import.