Using Gradescope LTI 1.0 with Brightspace (D2L) as an Instructor

Getting started

• Gradescope integrations with an LMS, such as Brightspace, are available with an institutional Gradescope license.
• When you access Gradescope through Brightspace, you and your students won't need to create or use a separate Gradescope password, because you will be authenticated via your Brightspace credentials.
• If you'd like to access your Gradescope account on the Gradescope website, you and students can go to the site and log in with your school credentials if your institution has that option.
• Otherwise, you can Sign Up via the Gradescope homepage with the email address associated with your Brightspace account. 

Below is the general process you should follow to be able to use Gradescope with Brightspace.

Step 1. Add Gradescope to your course-level navbar
Step 2. Link your courses
Step 3. Sync your roster
Step 4. Set up your assignment
Step 5. Grade submissions
Step 6. Post grades

Adding Gradescope to your course-level navbar

1. Access your course.
2. From the dotted menu, select either Edit this Navbar to edit one course navbar or Manage all Course Navbars to edit all your course navbars.

   If you already have a course-level Gradescope link in your navbar, you can jump ahead to the
   Linking Your Brightspace and Gradescope Courses section.

   
3. Select Add Links, on the Edit Navbar page. 
4. Select Create Custom Link from the Add Links modal.

5. Enter a name and for the URL, select Insert Quicklink.

6. Choose External Learning Tools and then Gradescope from the Insert Quicklink modal.
7. Don’t see Gradescope? Based on your institution’s configuration, you may not see the Gradescope course-level LTI link. If Gradescope isn’t listed, follow the LTI 1.3 tabbed instructions in Setting up your Gradescope Assignment to link your course while you are linking an assignment.
8. Select Create to close the Create Custom Link modal.
9. Make sure the Gradescope link is checked and select Add to close the Add Links modal.
10. You should now see Gradescope added to your navbar links list back on the Edit Navbar page.
11. Select Save and Close. Gradescope will now appear in the navigation bar for your course or courses.

Linking your Brightspace and Gradescope courses

Alternate method: This section and gif below show how to link your Brightspace and Gradescope courses starting on Brightspace. If you'd rather link starting on the Gradescope website, you still must have a course set up in Brightspace already. A Brightspace administrator may need to create the course for you. After that, log in to the Gradescope website, create a new Gradescope course or open an existing one, and link it back to Brightspace from the Gradescope Course Settings page.

1. Log in to Brightspace. Navigate to the homepage of the Brightspace course you'd like to link to Gradescope. If you don't see the course you're looking for, contact your Brightspace administrator or create one if you have the role permissions to do so. On your Brightspace course homepage click Content, and then either create a new module (click Add a module > name the module > Click Enter) or click the existing module where you'd like to add the Gradescope External Learning Tool.
2. In your module, click Add Existing Activities and choose External Learning Tools from the dropdown. When the Add Activity dialog box appears, click Gradescope (or the name your institution gave the Gradescope tool). If Gradescope isn't listed, contact your Brightspace administrator. Once you click the Gradescope link in the dialog box, you'll be taken back to your module where you will see a new link to Gradescope.
   Getting Gradescope to launch in a separate tab: Next to the Gradescope tool link in your module, click the down arrow > Click Edit Properties In-place > Select Open as External Resource. To use your Gradescope link right away, you may need to refresh the page. Gradescope will now open in a new tab when you and your students click the Gradescope link in the course module.
3. Click the new Gradescope tool link in your module. This will launch Gradescope in Brightspace or in a new tab, depending on your settings.
4. Once Gradescope launches, you'll see a dialog box with course-linking options. Choose to link to a new or existing course, and then click Link Course to go to the Course Settings page. New Gradescope users: At this point, a new Gradescope account will be created for you if you do not already have one associated with the email address (e.g., your school email) that you use in Brightspace. Existing Gradescope users: If you already have a Gradescope account under your school email address, as long as that's the email associated with your Brightspace account, clicking the Gradescope link inside Brightspace will take you to your existing account and a new account will not be created for you.
5. On the Gradescope Course Settings page, you can update the course title, description, rubric types, and score bounds. Keep in mind that course title and description changes made here will only appear in Gradescope, not in Brightspace. When you're finished, click Update Course. Your course is now linked and students will be able to access it.
6. Next, sync your roster.

Syncing your roster

1. Navigate to your Gradescope Course Dashboard. If you're continuing from the steps in the section above, you will already be there. If not, log in to Brightspace > Click your course > Click Content > Click the module where you added Gradescope > Click the Gradescope tool link there. Alternatively, you can log in to the Gradescope website and click your course. Both methods will take you to your Gradescope Course Dashboard.
2. On your Gradescope Course Dashboard, expand the left sidebar (if it isn't already) and click Roster to get to your Roster page. If your institution is using the latest version of the Gradescope tool (LTI 1.3), your roster sync button may display a customized name your institution has chosen instead of the word "Brightspace."
3. On your Gradescope Roster page, click the Sync Brightspace Roster button. A dialog box will appear explaining how accounts will be synced. All names, emails, and IDs will be auto-synced from Brightspace. Sections will be carried over from Brightspace, but groups will not. However, you can add groups easily or change sections if needed after you've synced your roster (see the note at the end of this section). All roles will be synced depending on how your institution initially configured your Gradescope integration. ID and section name syncing: If your institution uses the older version of the Gradescope tool (LTI 1.0+API), your IDs and section names will be auto-synced also.
4. By default, Gradescope will email users to say that they've been added to the course. If you don't want users to be notified, uncheck "Let new users know that they were added to the course" in the dialog box. Then click Sync Roster. If you haven't already associated your Brightspace account with Gradescope, you will be taken to the Brightspace login screen. After you log in to Brightspace, a message will appear asking if you'd like to authorize Gradescope. Click Continue and then click the Sync Roster button again in Gradescope.
5. If students add/drop in Brightspace, be sure to re-sync the roster. Existing submissions/grades for dropped students will be preserved. See the Adding Students and Staff article for more tips. If you have any roster-syncing issues, see the Troubleshooting section at the end of this page or contact help@gradescope.com. To change section names and add group names: After syncing, click Download Roster (bottom of Gradescope Roster page) > Add a Section and/or Group column with section or group values to the CSV file > Click Add Students or Staff > Upload the CSV back to Gradescope. Brightspace linking and any existing submissions and grades will be preserved as long as emails stay the same. Please note that if you re-sync your roster with the LTI 1.0+API version of the integration, you will lose any customized section names you added.

Setting up your Gradescope assignment

Linking a Gradescope assignment to Brightspace will automatically add an item to your Brightspace gradebook.

1. Navigate to your Gradescope Course Dashboard.
   1. If you're continuing from the steps in the section above, you will already be there.
   2. If not, log in to Brightspace > Click your course > Click Content > Click the module where you added Gradescope > Click the Gradescope tool link there. Alternatively, you can log in to the Gradescope website and click your course. Both methods will take you to your Gradescope Course Dashboard.
2. On your Gradescope Course Dashboard, click an existing Gradescope assignment or click Create Assignment to make a new one.
   1. If you're updating an existing assignment, click Settings in the left sidebar, make your changes, and then click Save.
   2. If you're creating a new assignment, next choose the assignment type and settings. See our Help Center article on creating an assignment for details on assignments and settings.
3. When you've chosen your settings, click Create Assignment.
   Your assignment is now updated/created. For student-uploaded assignments, once your release date passes in Gradescope, students will be able to submit work via the Gradescope website or by clicking the Gradescope tool link in their Brightspace course module.

Do I need to connect my Gradescope assignment to Brightspace? Yes, but not until you're ready to post Gradescope grades to your Brightspace Grades page. At that time you will need to connect your Gradescope assignment to a Brightspace grade item that you've set up to have the same overall point value as your Gradescope assignment. See Steps 1-3 of Posting grades if you'd like to do this now.

Grading submissions

1. Navigate to your Gradescope Course Dashboard. To do that, log in to Brightspace > Click your course > Click Content > Click the module where you added Gradescope > Click the Gradescope tool link there. Alternatively, you can log in to the Gradescope website and click your course. Both methods will take you to your Gradescope Course Dashboard.
2. On your Gradescope Course Dashboard, click the assignment and Grade Submissions in the left sidebar to start grading.
3. Once you do that, the process for grading is the same for Brightspace and non-Brightspace Gradescope users, so check out the detailed article on Grading Submissions. Once you've finished grading, be sure to connect your Gradescope assignment to a Brightspace grade item so you can post grades to Brightspace (see the next section).
   

Posting grades

1. First, make sure you've synced your roster.
2. Then to post Gradescope grades to Brightspace, you need to create or have an existing Brightspace grade item so you can connect your Gradescope assignment to it.
3. Make sure the overall point value listed in Brightspace for this grade item matches the overall point value listed in Gradescope for the assignment, and it's recommended that you choose "Numeric" as the grade item type.
4. If you've already connected your Gradescope assignment to a Brightspace grade item, launch the assignment in Gradescope, and then skip to Step 4. Creating Brightspace grade items: If you need help adding grade items, see the Brightspace instructor guide on Creating grade items.
5. Next, navigate to your Gradescope Course Dashboard by clicking the Gradescope tool in the appropriate Brightspace course module or logging in to the Gradescope website and clicking your course.
6. Once Gradescope launches, click the Gradescope assignment you'd like to link to a Brightspace grade item, expand the left sidebar, and click Settings.
7. Scroll down to the Brightspace Assignment section and click Link.
8. When the dialog box appears, select the name of the Brightspace grade item you'd like to link to from the dropdown. Your Gradescope assignment is now connected to your Brightspace grade item on the Brightspace Grades page.
9. With your Gradescope assignment open, expand the left sidebar (if it isn't already) and click Review Grades.
10. On the Gradescope Review Grades page, click the Post Grades to Brightspace button. When the dialog box appears, click Post Grades.

    Posting grades to Brightspace will only post the students' final assignment scores from Gradescope to the linked grade item in Brightspace. Only grades for fully graded submissions (which have a checkmark in the Graded column on the Gradescope Review Grades page) will be posted.

11. If you want students to also see their graded, annotated submissions, question-by-question scores, rubrics, and feedback on Gradescope, select the Publish Grades.
12. To alert students via email that their grades are now visible, select the Compose Email to Students  at the bottom of the Review Grades page.
13. To see what your students will see when they view their grades, check out the article on Using Gradescope with Brightspace as a Student.