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'd like to access your Gradescope account on the Gradescope website, you and students can go to gradescope.com and log in with your school credentials if your institution has that option. If you don't have that option, you can access the Gradescope website by clicking Sign Up on the Gradescope homepage and entering the email address associated with your Moodle account, or by logging in to your existing Gradescope account via the Log In button. Regardless of whether you access Gradescope on the website or via Moodle, you will be taken to the same Gradescope account, as long as the email address linked to the account is the same. If you or your students do end up with multiple accounts under multiple emails, you or they can merge accounts.
Once you decide how you want to access Gradescope, 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. Also, if you plan to access your Gradescope account starting on the Gradescope website rather than Moodle, look for the Alternate method notes on this page to help you with certain tasks.
- 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 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 the option to create and link to a new Gradescope course or link to an existing Gradescope course you may have. Choose new or existing, and then click Link Course to go to the Gradescope Course Settings page. If this is your first Gradescope login with these Moodle credentials, a new Gradescope account will be created for you. The username for your Gradescope account is the same email address that's associated with your Moodle 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. Alternatively, you can log in to gradescope.com and click your course. Both methods will take you to your Gradescope Course Dashboard.
- From 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, IDs, and section names will be auto-synced from Moodle. 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 to link: The next step shows you how to link your Gradescope assignment to Moodle. If submissions to this Gradescope assignment will be student-uploaded, it's highly recommended that you link your Gradescope assignment to Moodle before releasing it to students so they can access the assignment more easily. If submissions will be instructor-uploaded, it's recommended that you only link your Gradescope assignment to Moodle 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.
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 email@example.com.
- Make sure the Moodle activity/grade item is an assignment, quiz, or a Gradescope external tool activity.
- If the Moodle activity/grade item is a quiz, make sure it's configured to show points after the quiz is closed.
- Make sure the Moodle activity/grade item is not in a hidden grade category in your gradebook.
- Make sure the Moodle grade item was not created manually in your Moodle gradebook.
- 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. Alternatively, you can log in to gradescope.com, click your course, and then click your assignment. Both methods will take you to your Gradescope assignment.
- 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, or log in to gradescope.com, click your course, and then click your assignment. If Gradescope is launching from Moodle, you may also need to click your assignment once your course opens in Gradescope.
- 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 firstname.lastname@example.org.
- 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.