Table of Contents
Gradescope integrations with Learning Management Systems (LMSs), such as Moodle, are available with an institutional Gradescope license. When you access Gradescope through Moodle, you and your students won't need to create or use a separate Gradescope password, because you will be authenticated via your Moodle credentials. If you already have a Gradescope account under the email address that's associated with your Moodle account (e.g., your school email), when you access Gradescope in Moodle you will be taken to your existing account. If you do end up with multiple accounts under multiple emails, you can merge accounts.
Below is the general process you should follow to be able to use Gradescope with Moodle. In this guide, you'll find specific details for completing each of these steps and links to other pertinent Gradescope Help Center articles.
- Step 1. Link your courses.
- Step 2. Sync your roster.
- Step 3. Create and link your assignment.
- Step 4. Grade submissions.
- Step 5. Post grades.
Linking your Moodle and Gradescope courses
- Log in to Moodle. Click the course you'd like to link to Gradescope. Then, click the Turn editing on button in the top right corner of your screen.
- On your Moodle course page, click + Add an activity or resource. A dialog box will appear. In the dialog box, select Gradescope (or the name your institution has given the Gradescope tool) and click Add. Name your activity and click Save and return to course. It's recommended that you have the word "Gradescope" and your course title somewhere in the activity name. If Gradescope wasn't listed as an activity, contact your Moodle administrator.To embed or launch your Gradescope course in a new window: Make sure you're on the course settings page in Moodle > under General, click Show more > Under Launch container, choose how you want your Gradescope course to launch for you and your students (e.g., embedded in Moodle, in a new window, etc).
- Back on your Moodle course page, click the Gradescope activity link you just created. This will launch Gradescope. Once Gradescope launches, you'll see a dialog box with course-linking options. Choose to link to a new or existing Gradescope 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 Moodle.
Existing Gradescope users: If you already have a Gradescope account under the email address that's associated with your Moodle account (e.g., your school email), a new Gradescope account will not be created for you, and clicking the Gradescope activity link in Moodle will take you to your existing account.
- 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 Moodle.
- When you're finished, click Update Course. Your Gradescope course is now linked to your Moodle course and your students can access it. Now, it's recommended that you sync your roster.
Syncing your roster
- Navigate to your Gradescope Course Dashboard. If you just completed the steps in the section above you will already be on the dashboard. If not, log in to Moodle > Click your course > Click the Gradescope activity link in your course.
- On your Gradescope Course Dashboard, click Roster in the left sidebar to get to your roster page. On your Roster page in Gradescope, click the Sync Moodle Roster button.
- A dialog box will appear explaining how accounts will be synced. All names, emails, and groups/sections will be auto-synced from Moodle. You can add or change groups/sections after you sync your roster. See the note after Step 5. All user roles will be synced depending on how your institution initially configured your Gradescope integration.
- 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.
- Click Sync Roster. If students add/drop in Moodle, 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, contact firstname.lastname@example.org.To change section names: After syncing, click Download Roster (bottom of Gradescope Roster page) > Update section values on the CSV file > Click Add Students or Staff > Upload the CSV back to Gradescope. Moodle 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, you will lose any customized section names you added.
Creating a Gradescope assignment and linking it to Moodle
- Open the course in Moodle where you added the activity link to your Gradescope course. Be sure editing is turned on. Then click the + Add an activity or resource. A dialog box will appear. In the dialog box, select Gradescope (or the name your institution has given the Gradescope tool) and click Add. If Gradescope isn't listed as an activity, contact your Moodle administrator.Can I link a different type of Moodle activity to my Gradescope assignment? Yes, Moodle assignments or quizzes can also be linked to Gradescope assignments, but this type of link will only facilitate grade posting from Gradescope to Moodle. Linking a Moodle assignment or quiz to a Gradescope assignment will not create a link that you and your students can use to launch the Gradescope assignment from your Moodle course.
- Next, name the activity. It's recommended that you have the word "Gradescope" and the assignment title somewhere in the activity name. Then under Grades, either choose "Points" or "None" as the grading type. It is not recommended that you choose "Scale," because this option does not allow grades to post correctly from Gradescope to Moodle. Click Save and return to course.To embed or launch your Gradescope assignment in a new window: Make sure you're on the assignment settings page in Moodle > under General, click Show more > Under Launch container, choose how you want your Gradescope assignment to launch for you and your students (e.g., embedded in Moodle, in a new window, etc).
- Back on your Moodle course page, if you'd like, you can nest this new Gradescope assignment activity link under your existing Gradescope course activity link to help you distinguish one link from the other (hover over the assignment > click Edit > click Move right). Then click the Gradescope assignment activity link you just made. This will launch your Gradescope Course Dashboard.
- On your Gradescope Course Dashboard, click an existing Gradescope assignment or click Create Assignment to make a new one. 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. When you've chosen your settings, click Create Assignment.When should I link my assignment? The next step shows you how to create a direct link to your Gradescope assignment in your Moodle course. If submissions will be student-uploaded, it's highly recommended that you link your Gradescope assignment to Moodle before releasing it to students so they can find it more easily in Moodle. If submissions will be instructor-uploaded, it's recommended that you only link your assignment when you're ready to publish grades.
- Expand the left sidebar of your Gradescope assignment and click Settings. Scroll down to the Moodle Assignment section and click Link. When the dialog box appears, select the corresponding Moodle activity from the dropdown. Your Gradescope assignment is now linked to the corresponding column in your Moodle gradebook, and you and your students will see a link to the Gradescope assignment in the course in Moodle. To see what your students will see, check out the article on Using Gradescope with Moodle as a Student.
- Launch the Gradescope assignment you want to grade. To do that, log in to Moodle, click your course, and then click the Gradescope assignment or course activity link in your course. If you clicked the activity link connected to your Gradescope course, you'll need to click your assignment once your course launches in Gradescope.
- With your assignment open in Gradescope, expand the left sidebar (if it isn't already) and click Grade Submissions to start grading.
- Once you do that, the process for grading is the same for Moodle and non-Moodle Gradescope users, so check out the detailed article on Grading Submissions. Once you've finished grading, see the next section for posting grades so students can see how they did.
- Before trying to post grades, make sure you followed the steps in the sections above to sync your roster and link your Gradescope assignment to Moodle.
- Then open your graded Gradescope assignment. To do that, log in to Moodle and click the Gradescope activity link in your course.
- With your Gradescope assignment open, expand the left sidebar (if it isn't already) and click Review Grades to take you to the Review Grades page. On the Review Grades page, click the Post Grades to Moodle button. A dialog box will appear explaining how grades will be pushed from Gradescope to Moodle. In the dialog box, click Post Grades. Posting grades to Moodle will post the numerator (student score) and denominator (max possible score) of the student's final assignment scores to the Moodle assignment. Only grades for fully graded submissions (which have a checkmark in the Graded column on the Review Grades page) will be posted.If grades aren't posting: Re-sync the roster > Click Post Grades to Moodle again. If that doesn't work, email email@example.com.
- If you want students to also see their graded, annotated submissions, question-by-question scores, rubrics, and feedback on Gradescope, click the Publish Grades button.
- If you'd like to, click the Compose Email to Students button at the bottom of the Review Grades page in Gradescope to alert students via email that their grades are now visible. To see what your students will see when they view their grades, check out the article on Using Gradescope with Moodle as a Student.
I can only sync part of my roster.
If some members of your course can’t be synced along with the rest of your roster, most likely, these members do not have an email address associated with their account in Moodle. To fix the issue, either ask the course members or your Moodle admin to add the email addresses to the accounts in Moodle. Then re-sync the roster.
I can't sync my roster at all.
Please contact firstname.lastname@example.org.
After I unlink a Moodle course from Gradescope, the initially synced roster will remain on the Roster page even after I link a new course.
Please contact email@example.com to have the excess students removed. Alternatively, if there are no assignments within the course, you can delete it and create a new one to link with Gradescope.
The Moodle activity/grade item I need isn't listed as an option when I try to link it to my Gradescope assignment.
Occasionally, certain Moodle activities or grade items do not show up in the dropdown list when you're trying to link your Gradescope assignment to Moodle. If this is happening to you, use the list below to check that your Moodle activity or grade item is configured properly to link to Gradescope. Then if you're still having problems, please contact firstname.lastname@example.org.