Gradescope Student Tutorials

Finding your assignments

1. Log in to the Gradescope website on your computer, phone, or tablet. You’ll be taken to your Dashboard as soon as you log in.
2. On your Dashboard, select the course you’d like to view. This will take you to the list of assignments in that course that you’re able to submit. On this list, you will see the status of the assignment, the release date, and the due date. If your instructor has enabled late submissions for the assignment, you’ll also see a late due date.
3. Click on the assignment to open it and start submitting your work. Now, continue to the next sections of this guide for how to enter your answers or upload different types of files.

To submit a hand-written or typed assignment to Gradescope, the submission must be in the form of a PDF or an image, depending on the type of assessment.

To convert paper-based, handwritten work to a PDF, we recommend using a scanning app for mobile devices, such as Scannable (iOS) or Genius Scan (iOS or Android). Check out Submitting PDF homework in Gradescope to learn how to use these scanning apps and submit PDFs.

Variable-length submissions

In most cases, your instructor will allow you to turn in a variable-length submission for written assignments. This means your answers may span across any number of pages and responses may not be located in the same place on each page. If your instructor will accept a variable-length submission, when you open or start the assignment, you’ll have two options for submitting your work:

• Individual images, one or more per question
• One PDF that contains the whole submission; Gradescope will ask you to mark where each answer is

Fixed-length submissions (templated)

In some cases, such as when you’re turning in a worksheet, your instructor may want your responses fixed to particular locations on each page of the document you submit. This is called a fixed-length or templated submission. Because your instructor already knows where your responses will be, you only need to upload your completed PDF and will not be asked to indicate which page(s) contain the answers to each question. If your instructor would like a templated submission, when you open or start the assignment, you’ll only have one option for submitting your work:

• One PDF that contains the whole submission

Submitting a PDF

1. After you have the PDF of your work ready and you’ve selected the assignment (and clicked Start Assignment if it’s timed), a dialog box will appear where you can start uploading your work.
   • If your instructor has allowed it, you may also have a link to view, download, and print a PDF version of your assignment questions, instructions, or a bubble sheet that you can use to complete your work.
2. When you’re ready, click Submit PDF > Select PDF > locate the file > Upload PDF. You can only submit one PDF file per assignment. After you upload, your instructor’s assignment settings determine what you see on your screen next. If you’re taken to a page that asks you to assign questions and pages, go to Step 3. If a success message pops up, you’re done! Sit back and relax or go to Step 5 to resubmit.
3. On your screen, you should see a list of the questions/problems in your assignment and thumbnails of your PDF page(s). For each question, click the question on the left and the PDF page(s) that contains the answers on the right.
   • You can use the SHIFT key to select multiple questions at a time. You can assign multiple questions to the same page and multiple pages to one question. If each question is on its own page in your PDF, use the Assign Pages Sequentially button in the bottom action bar to quickly assign these pages. See the video at the beginning of this section for an example of how to properly mark your PDF.
4. Now, click Submit. When your submission is successful, you will be sent to a new page to view your submission, you’ll see a success message on your screen, and you’ll receive an email. If your submitted file looks good, you see the success message, and you get the confirmation email, you’re done!
5. If you need to, select the Resubmit button in the bottom right corner of your screen below your submission. Then, repeat the steps above as many times as needed before the assignment due date passes or the time limit runs out (if your instructor set one). Your instructor or TA will only see your most recent submission when they grade the assignment. All your past submissions are in your Submission History.

Submitting individual images

1. After you select the assignment you’re turning in, a dialog box will appear. In the dialog box, click Submit Images. You will be taken to a list of questions for your assignment.
2. 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.
3. Once you have finished adding images to all questions, click on Submit Assignment to complete the assignment submission.

Understanding timed assignments

For any assignment other than a Programming Assignment, your instructor can set a time limit on your work. This means you will only have a set number of minutes to upload your files or enter your answers from the moment you start the assignment or see the questions. Here are some things you should know about working on a timed assignment.

Initial dialog box

• You’ll know your assignment is timed if you see a dialog box about time limits when you first open the assignment.
• Read the dialog box carefully. It tells you how many minutes you have to work and the latest date/time you can begin working to have the full time available before the assignment due date and the late due (if your instructor set one).
• Only click the Start Assignment button in the dialog box when you’re ready to begin.
  

  

On-screen timers

• While you work, there will be a timer on your screen showing you how long you have left.
• You can hide and re-reveal the timer if you’d like.
• Depending on how long your time limit is in total, you may also see additional timer notifications on screen:
  • Time limit is < 3 minutes: no notifications
  • Time limit is < 10 minutes: notification at halfway
  • Time limit is < 20 minutes: notification at 5 minutes remaining
  • Time limit is < 60 minutes: notifications at halfway and 5 minutes remaining
  • Time limit is > 60 minutes: notifications at halfway, 15 minutes remaining, and 5 minutes remaining

Resubmissions

• In most cases (see next bullet point), you can reupload or re-enter response(s) as many times as you’d like until the time limit runs out or the due date passes.
• The timer will continue counting down even if you leave the Gradescope site.

Your instructor can set up what’s called an Online Assignment. Online Assignments let your instructor give you a mix of questions with some that ask you to enter your answers online in Gradescope and others that ask you to upload images or files containing your answers. Here are the ways you could be asked to give your answers in an Online Assignment:

• Short answer: you enter your response on Gradescope using a word, number/equation, or a few words. Responses are auto-graded as ‘correct’ or ‘incorrect’ based on an instructor-provided correct answer.
• Free response: you enter your response on Gradescope using multiple lines or paragraphs
• Multiple choice: you select the single correct answer from a group of options on your screen
• Select all: you select all the correct answers from a group of options on your screen
• File upload: you answer the question outside of Gradescope and then upload a file or image of the answer

Submitting an Online Assignment

1. After you select the Online Assignment you’d like to work on, the next thing you see will depend on whether or not your assignment is timed and has additional security measures in place.
   • Not timed: If you see and can start answering your questions, your assignment is not timed and there are no additional security measures. Continue to Step 2.
   • Timed: If you see a dialog box about time limits, your assignment will be timed. Read the dialog box to find the due date, the latest date/time you can begin working, and a Maximum Time Permitted field with how many minutes you will have to complete the assignment. While you work, there will be a timer that you can hide on your screen showing how many minutes are left. When you’re ready to open the assignment and start the timer, click the Start Assignment button.
2. Once you start your assignment, read each question carefully and pay special attention to how your instructor has asked you to provide your answer. You could be asked to provide answers to more complex questions in multiple ways.
   • If an answer field says “Please select file(s),” you need to complete your work on that question outside of Gradescope (e.g., by handwriting it, drawing it, etc.) and upload the image(s)/file(s) containing your answer. Gradescope accepts all file types for file upload questions on online assignments.
     

     

3. As you work, you can track how many questions you’ve finished and how many you have left along the top of your screen. Saving or submitting answers is slightly different based on whether or not your assignment is timed. See below:
   • Not timed: You will need to click the Submit Answer button as you finish each question. You’ll see a timestamp next to each answer you submit. Along the top of your screen, you can also track how many questions you’ve answered or started, but haven’t submitted. Any answers you haven’t submitted will have an asterisk next to them in your assignment.
   • Timed: Your answers will be autosaved as you complete them. You will not have a button to submit each one.
4. When you’re finished with the assignment, select View Your Submission to check your work. During the allotted time (if you instructor set a time limit) and submission period, you can submit or update your answers as many times as you need to. You will be graded based on your final answer for each question.

Code submissions

In addition to creating written and online assignments, your instructor can also set up programming assignments that allow you to submit code. For programming assignments, you’ll have three options for submitting your work:

• Drag and drop your code file(s) into Gradescope
• Submit a GitHub repository
• Submit a Bitbucket repository

To begin your submission:

1. After you select the Programming Assignment you’re turning in, a dialog box will appear.
2. When the dialog box appears, either drag and drop your code file(s) into Gradescope OR submit a GitHub or Bitbucket repository. If you choose to submit from GitHub or Bitbucket, you will first need to connect your account if you have not already. You will then be prompted to choose the repository and branch. You can upload as many files as you’d like, including files of different types.
3. Once you’ve chosen your file or repository and branch, select the Upload button. When your upload is successful, you’ll see a confirmation message on your screen and you’ll receive an email.
4. Next, wait a few minutes for the instructor’s autograder to grade your code file. When your results appear, scroll down to view any failed tests. If there are any errors, you can edit your code and click Resubmit at the bottom of your screen to resubmit your code file. Assignments can be resubmitted as many times as you’d like before the deadline, although some instructors may limit the number of times you can resubmit as part of their autograders.

Viewing Your Submission

Once your assessment has been graded, you will be able to see and access that grade on your course’s Gradescope homepage.

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 by clicking the Resubmit button on the bottom action bar.

For variable-length assignments, you may also reselect the pages at any time (even after the deadline has passed), up until the point when grading begins on your submission. If you need to reselect pages on your submission after grading has begun, please contact your instructor.

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. You’ll also be able to download your graded submission by clicking Download Graded Copy. Your instructor may choose to email you when grades are ready.

Grading Rubrics

Once your assignment is graded, you will see all grading rubrics, and rubric items applied to your submission will be highlighted. Click on a question name to view the rubric items for that question and any comments from your instructor. 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.

Regrade Requests

If your instructor has allowed it, you can submit Regrade Requests for questions you feel were graded incorrectly. When you view your submission, if you see a Request Regrade button in the bottom action bar, regrade requests are enabled.

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.

Once a request has been sent, your instructor(s) and 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.

You can view all pending and completed regrade requests for a course from the Regrade Requests page (in the left sidebar). Regrade requests that have been addressed by the instructor will be marked as “Completed”, and you’ll be able to see your updated score for that question.

You can also check the status of your regrade request when you view your submission. If the badge next to the question says IR, your regrade request is in review. If the badge says R, the regrade request has been resolved. After the regrade request is resolved, you can make another request by selecting the question and clicking the Request Regrade button again. You can see the complete conversation thread for a specific request by clicking on a question when you view your graded submission.

The method you are able to use to join a course in Gradescope is based on how your instructor set up the course and roster. You can find the short versions of these methods directly below or skip down to the extended instructions. If you run into any problems while trying to join a course, feel free to email us.

• Possibility 1 – Enrollment email (most common): Your instructor adds you. Your instructor elects to have Gradescope email you a link to access the course. You follow the instructions in the email.
• Possibility 2 – Gradescope website: Your instructor adds you, but does not elect to have Gradescope email you about your enrollment. You log in to the Gradescope website with your school email address. You find the course in Gradescope.
• Possibility 3 – Course code: Your instructor gives you a course code. You log in to the Gradescope website with your school email. You add yourself to the course with the course code.

Joining a course via an enrollment email from Gradescope

1. Check your school email inbox for an email from Gradescope saying you were added to a course.
   1. New users: If this is your first time accessing Gradescope with this email address, next, click the “Set your password” link in the body of the email. Enter and confirm your password, and then click Save. Once you set your password, you’ll be taken to your Gradescope Dashboard where you can find your course.
   2. Existing users: If you already have an account with this email address, click the link to your course in the body of the email. This will take you to the Gradescope login screen. Enter the email address shown in the email from Gradescope and enter your password. If you need to, you can also click Forgot your password? You’ll receive an email with a password reset link and instructions. Once you set your new password, you’ll be taken to your Gradescope Dashboard where you can find your course.

Joining a course via the Gradescope website

1. If your instructor told you to log in to Gradescope but did not give you a course code or an enrollment email, navigate to the Gradescope website.
2. Click the Log In button (top right corner). Then enter your email address (most likely your school email). Alternatively, if your school has the option, you can click School Credentials on the login screen and access Gradescope via single sign-on.
   1. New users: If this is your first time accessing Gradescope with this email address, next, click Forgot your password? Enter your school email address. You’ll receive an email with a password reset link and instructions. Once you set your new password, you’ll be taken to your Gradescope Dashboard where you can find your course.
   2. Existing users: If you already have an account with this email address, enter your password. This will take you to your Gradescope Dashboard where you can find your course.

Joining a course using a course code

1. If your instructor gave you the entry code for the course, you will be able to add yourself as a student.
   1. New users: If you don’t have a Gradescope account yet, go to the Gradescope website, click Sign Up in the upper right corner, select Student, and put in your entry code in the sign-up form. Note that your instructor may choose to disable the entry code and not allow students to use entry codes to enroll. If the entry code doesn’t work, please email your instructor for details on how to access the course.
   2. Existing users: If you already have a Gradescope account, log into that account and navigate to your Account Dashboard by clicking the Gradescope logo in the top left, and click Add Course in the bottom right corner. Then enter your course code.

For the majority of your paper-based and handwritten Gradescope assignments, you need to scan hard copies of your pages and save them as a PDF before submitting. No scanner? No problem. Keep reading to learn how to scan from your phone and then how to submit your scans in Gradescope from your computer, phone, or tablet.

Scanning on iOS devices

1. DOWNLOAD: In the App Store, download Evernote Scannable (our recommended app for iOS devices). You can also download and follow a similar process with Genius Scan or another scanning app that produces high-quality PDFs.
2. SCAN: Open Scannable. Click the three dots > Settings > File Type > PDF. Then, click the back arrow > Done. Hold your phone above each page. The app will scan each page automatically as soon as it finds it. When you’ve scanned every page, click the check mark.
3. REVIEW: Review your scans. Make sure all pages are in one PDF. If your scans are blurry, see Tips for Scanning below. Name your file by tapping the file name next to the PDF icon.
4. SHARE: Click Send. Then, click Mail to email the scans to yourself or click Share > Save to Files or Dropbox (or another cloud service). You may need to scroll to find all the “Save to…” options on your phone.Now, you’re ready to turn in your work.

Scanning on Android devices

1. DOWNLOAD: In the Play Store, download Genius Scan (our recommended app for Android Devices). You can also download and follow a similar process with another scanning app that produces high-quality PDFs.
2. SCAN: Open Genius Scan. Select the camera icon on the main screen. If you’re scanning multiple pages, tap the image icon in the top right corner of the screen to switch to batch mode. Hold your phone above each page and click the spinning circle. Repeat for each page. The number in the circle will track how many pages you’ve scanned to the document. Click the check mark when you’ve scanned all your pages.
3. REVIEW: Make sure all your pages are in one document. Name your document by tapping the name file name at the top of your screen. Review your scans for legibility. If your scans are blurry, see Tips for scanning below.
4. SHARE: Select your document, click the Share icon. Make sure the Format is set to PDF. Then, click Mail to send it to yourself, click Device Memory to save it on your phone, or click Google Drive or Dropbox (or another storage option) to save it to the cloud.Now, you’re ready to turn in your work.
   

   

Tips for scanning

• Use dark lettering: Use the darkest pen, pencil, or font color possible to do your work.
• Scan on a flat surface: Scan on a dark table with high contrast to your paper.
• Steady your hands: Hold your phone at a bird’s eye view and scan your pages slowly with steady hands.
• Enhance, if needed: Check your scanning app’s settings for filters that let you enhance, restore, lighten, or darken your scans.

If your instructor has enabled late submissions for the assignment, you may upload a submission after the deadline (but before the late deadline). Note that late submissions may be subject to penalties, as determined by your instructor.

If you were not able to submit an assignment before the late submissions deadline, or if late submissions are not enabled for your assignment, please contact your TA or instructor. 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 View or Edit Group 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.

Submission best practices

When you start to work on any assignment that you’ll be submitting to Gradescope, it’s recommended that you leave yourself ample time to upload your files. If you are working on a variable-length or online assignment where your instructor has allowed you to choose the type of file you’d like to upload, it’s highly recommended that you submit PDFs rather than images. If you will be scanning your work, it’s also highly recommended that you use the scanning apps and instructions in the Scanning Work on a Mobile Device article to create PDFs that are small in size, high-resolution, and are guaranteed to work with Gradescope. If you’ve used the best practices explained above and are having issues submitting your work, see the table and steps below to try to fix the problem.

If all else fails, please contact help@gradescope.com from the email address associated with your Gradescope account. In your message, be sure to include the name of the course, assignment, and a screenshot or screen recording of any error notifications you see.

General troubleshooting steps

1. Use the Possible problems and solutions table below to try to determine the cause of your submission errors. Correct the errors, if possible. Be mindful of how much time you have left before the due date will pass or the timer will run out (if your assignment has a time limit).
2. Then, try to open the assignment in Gradescope.
   1. Assignment still opens: If you’re prompted to submit your work, follow the instructions above on submitting an assignment. If you’re trying to resubmit, check for a Resubmit button at the bottom of your screen. If you still see one, click the Resubmit button and re-upload your work. Unless you were working on an Online Assignment, be sure to wait for an emailed submission receipt and a success notification on your screen before navigating away.
   2. Assignment does not open / no Resubmit button: Your timer may have run out or your due date may have passed, so you will not be able to resubmit. If you suspect that’s the case, then contact your instructor to see how they would like you to proceed. If needed, your instructor will be able to submit your work for you or extend your time limit at their discretion.