To create a new course, go to your Account Dashboard by clicking on the Gradescope logo in the top left corner of the screen, and click Create Course in the action bar at the bottom.
Any user who is an instructor of any course, including our demo “Gradescope 101” course, can create new courses.
There is no course search functionality on Gradescope, and your course is not exposed to any search engine. Only those who have been explicitly added to the course will be able to see it. Our help item on the course roster has more information on adding users to a course.
To change coursewide settings, navigate to the course you wish to modify and click on Course Settings in the left sidebar. If you make any changes, be sure to click Update Course before navigating away from the page.
You can also delete the course on this page. Note that you cannot currently delete a course if any student submissions have been uploaded. Delete all student submissions first, or email us if you’d like to delete a course in this situation.
The course roster is necessary to match students to submissions, manage course staff permissions, and allow students to see their work on Gradescope.
Gradescope has three staff roles: Instructors, TAs, and Readers. Currently, all three roles have the same permissions when it comes to adding/removing students, uploading, naming, grading, and responding to regrade requests. In the roster, Readers cannot increase their role to TA or Instructor, and TAs cannot increase their role to Instructors. Instructors are emailed about all regrade requests, but TAs and Readers are only emailed about regrade requests on question submissions that they graded.
In the action bar of the Roster page of your course, you can see the course entry code. If you let students know your course’s entry code, they will be able to add themselves to your course (see our help item on how students can add themselves to a course).
To add members to your roster, click on Add Students or Staff in the bottom right hand corner of the Roster page of your course. A dialog will appear allowing you to add a single user or upload a CSV file to add many users at once. We recommend adding your students via a CSV file to speed up this process.
Once you have uploaded the CSV, you will be asked to match the columns of your CSV with Gradescope fields.
You can include extra columns such as
Section Number: just press the button on the right of the column names and select the relevant column.
Note that we currently don’t display information from the extra columns on the Course Roster page, but we do include it in all spreadsheet downloads.
Lastly, you can choose to send an email notification to the users being added. Generally, if your first Gradescope assignment will be instructor-submitted, like an exam or quiz, you shouldn’t send this notification when adding students. They won’t be able to do anything, and you can notify them via email when their first assignment is fully graded. If your first Gradescope assignment will be student-submitted, you should notify students when adding them, so that they can log in and submit their work.
To make any modifications to the roster, you can click on the Edit Student button next to the student’s name that you wish to edit. You can also upload a new CSV file to update your roster in bulk; email addresses will be used to match rows in the file to existing students.
To create a new assignment, click Create Assignment in the bottom right corner of your course’s Assignments page.
The template PDF should be a blank version of your test, or instructions such as a list of assigned homework problems. This PDF is used in further steps of Gradescope such as Creating an Outline.
Note that students will not have access to this file—you must distribute it yourself if you want students to have it.
This type of assignment is usually a quiz or exam, and will require scanning by the course staff.
NOTE: Here’s the sample template used in the video.
For student-uploaded work, there are a few extra options to set.
The Release Date specifies the date and time when students will become able to submit their work. The Due Date specifies when students will stop being able to submit their work.
NOTE: Late submissions by students are not supported yet, but the feature is in development. In the meantime, instructors can upload submissions for students after the deadline, from the Manage Submissions page.
The submission type has to do with what format you expect students to upload their work in.
If Group Submissions are enabled, students will be able to add group members to their submission. The groups can change all the way up to the deadline, but you will always be able to see everyone’s full submission history.
If you ever wish to change any of these settings, you can access them in the Assignment sidebar under Settings.
Deleting an assignment is possible from the Settings page. Upon clicking the Delete Assignment button, you will be prompted to confirm your action.
Currently, if the assignment that you wish to delete has student submissions you will not be able to delete it. If you still wish to do so, you can email us and we will gladly delete the assignment for you.
Assignments can be duplicated, with the template, question outline, and all question rubrics copied.
To duplicate an assignment, navigate to the Assignments page of the course where you want the new assignment to be created. Click on Duplicate Assignment in the action bar to bring up the assignment duplication dialog.
You will then see a list of your courses. If you click into one, you will find the list of the assignments for that course. Select the assignment you want to duplicate, and enter the title of the new assignment. Note that you can’t have two assignments with the same name within the same course.
To download all the assignment grades as a spreadsheet, navigate to the Assignments page, and click the button in the bottom action bar titled Download Grades. All assignment grades and roster information (including extra columns) will be included in this spreadsheet.
Gradescope allows you to grade paper-based exams, quizzes, and homework. In addition, Gradescope enables you to autograde programming assignments (in beta).
For paper assignments, Gradescope works well for many types of questions: paragraphs, proofs, diagrams, fill-in-the-blank, true/false, and more. Our biggest users so far have been high school and higher-ed courses in Math, Chemistry, Computer Science, Physics, Economics, and Business — but we’re confident that our tool is useful to most subject areas and grade levels. Please reach out to us and we can help you figure out if Gradescope will be helpful in your course.
For programming assignments, there is full flexibility in setting up whatever language, compilers, libraries or other dependencies you need. You provide us with a setup script and an autograder script, along with whatever supporting code you need, and we manage accepting student submissions, running your autograder at scale, and distributing the results back to students and to you.
To grade exams or quizzes you will start by creating the assignment. For the option of “Who will upload submissions”, choosing Instructor will allow the instructor(s) to upload student work (Creating, editing, and deleting an assignment).
Once the assignment is created, you’ll mark the question regions on a template PDF (Creating an outline), upload and process scans (Managing scans), match student names to submissions (Managing submissions), and grade student work with flexible, dynamic rubrics (Grading). When grading is finished you can publish grades and email students (Reviewing grades) as well as export grades (Exporting Grades) and manage regrade requests (Managing regrade requests).
Homework has an even simpler workflow because students will mark where their answers are on their submissions (Submitting an assignment). You start by creating a “Student” uploaded assignment rather than an instructor-submitted one. For student-uploaded assignments there are a few more options, such as release date, due date, and group submission policy (Creating, editing, and deleting an assignment).
Next, you will create the assignment outline (Creating an outline) and wait for students to submit their work. You can begin grading as soon as a single submission is uploaded. The rest of the workflow is the same as Exams & Quizzes: you can publish grades, email students (Reviewing grades), export grades (Exporting Grades), and manage regrade requests (Managing regrade requests).
Programming assignments are still in beta and we would love to hear from you about how we can meet your code autograding needs. If you would like beta access, please send us an email.
As an instructor, you can create a new programming assignment on Gradescope, and upload your autograder zip file following our specifications. Your code produces output in the format that we request. Students submit to Gradescope and have their work evaluated on demand. They can submit as many times as they want, and get results back as soon as the autograder finishes running. At the end of the process, you can download their code and their results.
If you wish to get more familiar with setting up programming assignments, check out the Gradescope Autograder Documentation.
You can also grade students’ code manually using the Gradescope grading interface. To enable manual code grading, when creating a programming assignment, check the “Enable Manual Grading” box, and fill in the question title and point value. You can also enable this on the settings page for an existing assignment. Your students can then upload their code, and you can grade it from the Grade Submissions tab.
Creating the Assignment Outline is the first step within the Assignment Workflow. In this step, you create questions and tell Gradescope where each question is located, if it’s a fixed-template assignment.
You will see the Template PDF on the left and an empty outline on the right. To start creating an outline click + new question to begin adding questions. You can title your questions and add point values.
In addition, you can create subquestions by clicking the teal “add subquestion” icon (to the right of the red “x” delete icon), or by dragging a question into another one. You can also drag a subquestion outward to turn it into a question.
You can always remove a question, a subquestion, or a group of subquestions by clicking the red “x” delete icon next to each of these items.
When creating outlines for fixed-length assignments, you can set the region where students will write their names. Creating a name region is necessary for the Manage Submissions step of assigning names to submissions. Click the Select name region button to create a name region that covers all relevant student-identifying information. If you’ve already selected the region, the button will say Name region selected. Just like manipulating a question box, you can drag and resize the box over the desired area of the PDF.
For fixed-length assignments you will also need to specify the areas where students will write their answers. You can do this by resizing and dragging question boxes on your Template PDF. You can also create new questions and subquestions by clicking and dragging on the PDF.
When grading an assignment, the viewer will automatically zoom to the region you designated. It’s generally helpful to create regions that are slightly larger than the actual area you expect students to use.
Manage Scans is only part of the workflow for instructor-submitted assignments. For student-submitted assignments, this page will not appear in the assignment workflow.
Once you have your PDFs ready to upload, select your files and click Upload scan(s). While you can upload a PDF for each student submission, we recommend uploading PDFs that contain multiple student submissions for faster processing.
Once the scans have been uploaded, click Show to view the pages of your PDF. Based on the length of your Template PDF (which you uploaded when you first created the assignment), Gradescope proposes a splitting of your scans. For example, if your template was 8 pages long, we split your scans every 8 pages. This means that if your template is only 7 pages long and you expect your submissions to be 8 pages long (for example, if you have an extra sheet for student overflow work), we suggest adding an extra blank page to the Template PDF to match the expected submission length.
NOTE: To replace the Template PDF, navigate to the Settings for the Assignment.
Be sure to review the recommended splitting to make sure your scans turn into correct submissions. An easy way to check this is to look at the first and last page of each submission to make sure that they match the template. If a proposed submission has out of order pages or an extra page, you can reorder pages and set your own split points by dragging a page from one submission to another.
Once you have reviewed all the proposed submissions you can confirm the proposals by clicking Create Submissions at the bottom of the page.
Manage submissions allows you to quickly assign student names to submissions. When you click on an empty student name field, a two panel view appears: on the left are the student names from your roster, and on the right is a view of the name region that you set up in the Edit Outline step.
Type in the name of the student (or just a few letters with auto-complete), hit Tab (rather than Enter) to select the user, and repeat until there are no more submissions.
You can also toggle between unassigned submissions and all submissions (top right corner), allowing you to focus on submissions that haven’t been matched yet.
NOTE: If you are having a hard time interpreting the student’s name due to sloppy handwriting, you can also try matching the student via their ID number.
There are three core components to the grading page. They are the student submission area, the rubric, and the bottom action bar.
Grading a submission is as simple as clicking on a rubric item (the box with a number in it) or pressing the number on your keyboard corresponding to the rubric item. To move to another submission, click Next Ungraded to be taken to another student’s submission for the same question.
The rubric allows you to grade quickly and consistently, applying the same set of feedback to every submission. When you grade with Gradescope you can change the rubric at any time. This means if you took off too many points or gave too many points for a particular rubric item, you can change it and Gradescope will automatically apply those changes to the other students who received the same mark.
By clicking on Rubric Options you will see that Gradescope supports two different styles of grading. Positive Scoring means that rubric items default to adding points, starting from 0. On the other hand, with Negative Scoring (the default mode), rubric items default to subtracting points from the total points available for that question. If, for some reason, you want to have a rubric item that has the opposite effect of the default scoring style, add a minus (-) before the value.
There are also options for a point ceiling to prevent scores greater than 100% and a point floor to prevent scores less than 0%. These are both enabled by default so that you don’t get scores out of the expected range, but you can disable them for extra credit questions or other situations where you don’t want the default behavior.
Rubric items are consistent for each question, which means that you can apply them to any number of submissions. However, sometimes you want to give local, individual feedback. You can do this with Submission Specific Adjustments which allow you to add or subtract points as well as provide specific comments to the submission.
The question navigation menu (top left of the rubric) allows you to move to a different question. Click on the question title and a drop down menu of questions will appear, allowing you to jump to another part of the assessment.
Once you understand the basics of interacting with Gradescope, you can speed up your workflow by using keyboard shortcuts.
Each rubric item can be marked by using the number keys on your keyboard. The arrow keys take you to the next submission (right arrow) and the previous submission (left arrow). The period key (.) and the comma key (,) move between the next and previous question in the same submission. The z key moves to the next ungraded submission. To zoom in and out quickly you can use the f and g keys. Lastly, the shortcut a will take you to the list of all submissions for the current question.
To see these in action check out the video below.
You can use LaTeX to add math symbols in rubric items, comments, and regrade requests and responses. For more details, check out our FAQ.
To go to the your last-viewed submission, you can use the back button in your browser. You may also open multiple tabs at once to grade multiple students’ submissions at the same time.
The list icon to the left of the question title allows you to navigate to the Question Submission Index page. This page lists all the submissions for the question that you are on. It displays information such as the grader, the score that was given, and whether a submission was graded. If you are looking for a particular student’s submission to a question, this is an easy way to find it.
When you hover your mouse over the Submission View, more options appear that let you manipulate the submission.
In the top left, you can toggle between the full page view and the question only view. The question only view allows you to change your view to the region that you set up during the Edit Outline step. The Full Page view allows you to see the whole page of the submission.
If a student wrote their response on a different page than the location that you expected, you can use the View Next/Previous page arrows to navigate to other pages of the submission. You can also click Browse Pages (bottom left) to view all the pages of the submission and jump to other pages.
In the top right are annotation tools to allow graders to mark on a student’s submission. Students can see these marks, which can help the student identify what part of the submission you want them to focus on.
There are also few ways to zoom.
If you move the submission around or zoom in/out and want to save this view to be the default view for that question, you can click Save View.
NOTE: Saving the submission view only affects your default view of that question and will not affect other graders’ default view. If you wish to change the default view for all graders edit the question’s region in Edit Outline.
Lastly, you can rotate the submission by clicking on the rotate button next to the zoom tools in the bottom right corner.
Once you are finished grading submissions, the Review Grades page gives you an overview of what was graded and allows you to publish grades, email students, and export evaluations & grades.
In order for students to be able to see their grades via Gradescope, grades must be “Published”. You can do so by clicking Publish Grades. You can check whether or not grades have been published by looking at the top right indicator. It will say “Grades Published” in blue if grades are published, or “Grades Not Published” in grey if they are not. You can also unpublish grades by clicking on Unpublish Grades.
Publishing grades does allow students to see their graded work, but simply publishing grades won’t notify students. If you wish to send an email to the students who submitted work, you can notify them by clicking Compose Email and filling out the form. Only students who have a fully graded submission will be emailed.
With Gradescope, students have the ability to submit regrades requests with statements as to why they think their submission should have another look. You can disable this feature by clicking Disable Regrade Requests either on the Review Grades page, or from the Regrade Requests page.
By default, all rubric items are shown to students. We believe this helps students learn from their mistakes and assures them that grading was fair and accurate.
However, in some cases it may be preferable to hide all or part of the rubric from students. You can change this from the Assignment Settings page. There are three options for hiding rubric items:
Note that no matter which option is selected, students will always see submission-specific comments and point adjustments.
From the Review Grades page, all data can be downloaded from Gradescope in CSV and Excel formats.
Gradescope offers two types of downloads:
Regrade Requests allow students to submit short statements about why they think their work should be given another look. When students submit a regrade request, the instructor and the grader who last graded the question will receive an email detailing the request and how to view it.
All instructors, TAs, and readers can view all regrade requests under the Regrade Requests page.
Clicking Review will take you to the student’s submission. To read the student’s request, click Regrade Request in the bottom right of the rubric, next to submission-specific adjustments.
You can make changes to the grading by clicking other rubric items or by applying point adjustments. You can also modify rubric items which will change how all other students are graded, as it would during the grading process. If you just want to give a specific change to the student, use point adjustments.
To close the regrade request, type a reply to the student and click Close & Respond. The student will receive an email detailing your response, and can view their adjusted grade on Gradescope. If a student has any further concerns, they can reply (in Gradescope) which will re-open the regrade request.
The Statistics page allows instructors to gain further insights into what their students have learned. The default view showcases the averages from each question. Clicking a question’s bar within the chart will focus on it, updating the stats under the chart.
You can also tag each question with concepts. By clicking “Show Tags”, you can then switch into Tag View to see the breakdown of points by tag.
If you click a question in the table below the chart, you can see that question’s statistics, showing you how often each rubric item was applied. This allows you to pinpoint particular difficulties or concepts that students struggled with.
NOTE: We would love to hear from you about how we can meet your data analysis needs. If you have feedback, please send us an email.
If your instructor gave you the entry code for the course, you will be able to add yourself as a student. To do this, navigate to your Account Dashboard by clicking the Gradescope logo in the top left, and click Add Course in the bottom right corner.
If you don’t have an entry code, your instructor must add you to the course.
NOTE: Sometimes instructors use a different email address from your Gradescope account. If you were added to a course, but you don’t see it in your Account Dashboard, check with them to see what email address they used. If you end up with multiple accounts, email us and we can merge them for you.
If you were added to a course that you’ve dropped, please email your instructor and ask him or her to remove you from the course roster.
NOTE: We have a PDF version of this section for use as a handout.
To turn in homework on Gradescope, you will need to create a PDF of your work and save it to your computer before submitting.
There are many scanning apps to create PDFs on iOS. In particular, we recommend the app Scannable by Evernote. You can also follow a similar process with other scanning apps, just make sure the app you choose will let you make high quality PDFs.
TIP: When setting up Scannable, it’s a good idea to click … > Settings > File Type > PDF. This way, your single page assignments save as PDFs.
Similar to iOS, Android has many apps to create PDFs. We recommend Genius Scan. You can also follow a similar process with other scanning apps, just make sure the app you choose will let you make high quality PDFs.
TIP: As you take your photos, you can save your scans to a document by selecting Move To. Whether you do it before or after scanning, make sure that the pages of a multi-page homework are all in one document and not in individual scans.
Taking your photos: Place your work on a flat surface. (A darker table with high contrast to your paper is best). Hold your camera directly above the paper with a steady hand, parallel to the table. Always check that your photos are clear—if you try to speed through you will get blurry photos!
If your scan is blurry or illegible: Try retaking the photo. If you have a flash on your device, try using it, but make sure there isn’t any glare in the final result. Then, try changing the enhancement of the photo after your crop your photo. If your writing is light, start by looking for tools called “Sharpness” and “Contrast.”
If your scan is still illegible: You might have written your assignment too lightly or unclearly. Make sure you use a dark pen or pencil!
Assignments you’re able to submit on Gradescope will appear on the course dashboard. You will be able to see the status of the assignment, the release date and the due date.
Most student-submitted assignments will be of variable length, meaning that answers will not always be located in the same place, and can span across any length of pages.
Clicking on an unsubmitted assignment will bring up a dialog where you will have two options for submission:
If you choose to submit individual images, you will be taken to a list of questions for your assignment.
Click on Select images for the first question and choose the images that correspond to the question. Repeat this until you have submitted images for all the questions in the assignment. Once you have finished adding images to all questions click on Submit Assignment to complete the assignment submission.
If you choose to submit a PDF, you will be prompted to upload your file. Once submitted, you will be asked to mark which pages of your PDF correspond to questions of the assignment.
For each question, mark the pages containing the answer by clicking on the PDF thumbnail. For example, if the first two pages of your PDF have a response to the first question, mark the first two thumbnails under the first question section. If your response to the second question is on the second and third pages of the PDF, mark the second and third thumbnails under the second question section. Continue to do this until all questions have their corresponding pages marked. See the video in the beginning of this section for an example of how to properly mark your PDF.
NOTE: If you create a PDF where each question is on its own page, you can quickly assign these pages by using the Assign Pages Sequentially in the top right of the page.
In some cases, your instructor may assign worksheet-style homework, where your responses are fixed to particular locations. Because your instructor already knows where your responses will be, you only need to upload your completed PDF and will not be asked to assign pages.
If you were not able to submit an assignment on time, please contact your TA or instructor about it. They can manually upload a submission for you after the deadline if they wish to allow it. The Gradescope team cannot make course policy decisions on their behalf.
If your instructor has allowed it, you can add group members to your submission.
You can add members either by clicking on Group Members in the action bar or by clicking Add Group Member in the outline area of the submission.
You can edit your group via the same dialog.
Whenever a user gets added or removed from a group, they will receive a notification email.
To view your assignment submission, click on an assignment from the course dashboard. If you have already submitted the assignment, you will be able to view your submission. You can resubmit from this page any number of times until the submission deadline.
Until your course staff have finished grading, you will see this ungraded version of this page. Once your instructor publishes grades, the status changes from “Ungraded” to “Graded,” and you will be able to see the total score as well as the scores for each question. Your instructor may choose to email you when grades are ready.
Once your assignment is graded, you will see all grading rubrics, and rubric items applied to your submission will be highlighted. Viewing the rubric is a great way to get feedback about your work, and helps ensure that it was graded fairly.
Note that in some cases, instructors may choose to hide some rubric items. If no rubric items are shown, there will be a message letting you know. However, any comments and point adjustments specific to your submission (that don’t use a rubric) will always be shown.
If your instructor allows it, you will also be able to submit regrade requests by selecting a question and then clicking Request Regrade from the bottom action bar. For more information, see our help item on regrade requests.
Click Download Submission to get a PDF containing your submission and detailed rubric markup.
If your instructor has allowed it, you can submit Regrade Requests for questions you feel were graded incorrectly.
To submit a Regrade Request, first click on the question that you wish to submit a request for. This will display the rubric for that question and highlight the rubric items that were applied. Once a question has been selected, click the Request Regrade button in the bottom action bar. A textbox will appear allowing you to type an explanation of the request for the specific question that was chosen.
Tip: Instructors are most likely to respond to regrade requests when they are polite and concise.
NOTE: Regrade requests are per question, so if you have multiple requests, make sure to submit one for each question that should be reviewed.
Once a request has been sent, the grader(s) who graded the question will receive an email notifying them of the request. The grader(s) can then optionally re-grade the question, reply with a response, and close the request. Upon closing the request, you will receive an email notifying you the request has been resolved.
If you have forgotten your password or are otherwise unable to log in, please visit the password reset page and enter the email address you are registered with. This will allow you to set a new password and log in.
If you are a student, your instructor should have added you to Gradescope. If you can’t remember what email address your account is under, try your university email first. Your course staff can also check the roster in Gradescope for you, so you can ask them to look it up.
Occasionally, users will end up with two accounts with courses split across them. Currently, there is no way to merge accounts via the Gradescope interface. Contact us and we can do this for you.
Gradescope works well for a wide variety of answer types: paragraphs, proofs, diagrams, fill-in-the-blanks, multiple choice, and more. Our biggest users so far have been high school and higher-ed courses in Math, Chemistry, Computer Science, Physics, Economics, and Business — but we’re confident that our tool is useful to most subject areas and grade levels. Please reach out to us and we can help you figure out if Gradescope will be helpful in your course.
Yes, Gradescope is built to allow multiple graders to grade at once. The easiest way is to have each person grading their own question, but multiple people can also grade the same question without a problem, as long as they use the Next Ungraded button to navigate. This will ensure that graders never see something that someone else is looking at or has already graded.
You have two options
For best scanning practices check out our video below!
Most instructors find that even with scanning, Gradescope saves them 30-60% time compared to grading on paper. Once you’ve done the scanning process once, the subsequent scans will go much more quickly.
In addition to grading being much faster, you don’t have to spend time in class returning work, or time in office hours on regrade requests. With scanning you also avoid students cheating by changing their answers after they get their work back.
Before you buy a scanner, you should check whether or not your school already has a scanner, or a networked photocopier. Many newer copiers have high quality, scan-to-email functions that are worth testing.
However, standalone scanners sometimes provide better results, and are easier to share between courses. There are roughly three price points of scanners well-suited for Gradescope: about $400, about $800, and $1600 and up.
We plan to integrate with most major LMS providers (Canvas, Blackboard, Moodle), starting with Canvas. Currently, integration is manual: you can import your course roster as a CSV file to Gradescope, and download Course or Assignment grades as spreadsheets for upload to the LMS.
Interested in closer integration with your school’s LMS? Let us know!
We use students’ email addresses to make accounts that they can log in to. Once logged in, they can submit work, view their graded work, and request regrades of their graded work. If you want to use Gradescope for grading only, without your students ever logging in, you can upload fake email addresses (e.g. ending with @example.edu), upload their submissions yourself, and then export grades as a spreadsheet.
Yes, you can use LaTeX to include math symbols in rubric items, comments, and regrade requests and responses.
We support two modes of using LaTeX:
Questions about how to use LaTeX on Gradescope? Let us know!
Below, we list the relevant requirements from FERPA and explain how Gradescope meets these requirements.
|FERPA Requirement||How Gradescope Meets Requirement|
|Performs an institutional service or function for which the agency or institution would otherwise use employees.||Gradescope aids you in grading and understanding student work, which is a function of the institution's employees.|
|Is under the direct control of the agency or institution with respect to the use and maintenance of education records.||We only use educational records to perform and improve the service. We will delete student records upon request.|
|Is subject to requirements governing the use and redisclosure of personally identifiable information from education records.||We do not redisclose personally identifiable information, except as directed by the institution or student.|