Importing Google Classroom Classes and Rosters
This article walks through importing Google Classroom classes and rosters into PaperScorer, and covers what happens when rosters change later. It assumes your Google Classroom account is already connected — if it isn’t, see connecting your account to Google Classroom first.
Running an Import
From any page in the application, click the create button and select the Class option.

From the “create new class” modal, select Google Classroom import. (You may see additional options depending on which other accounts you have connected.)

You’ll see a list of available Google Classroom classes you can import.
NOTE: Only active Google Classroom classes are available to import. If a class is missing from the list, check the Google Classroom portal and make sure the class is still active (not archived).

- Name (required): the class name as it appears in Google Classroom. You can change it to something different before saving in PaperScorer.
- Section (optional): the section label as it appears in Google Classroom. You can also change this before saving.
- Import (required): how PaperScorer should handle this class record at import time:
- Do not import class — the class will be skipped.
- Import with X students — the class will be imported along with its roster.
- Import without students — the class will be imported, but no students will be added. You can add or import them later.
After the import finishes, you’ll be redirected to your active class list and the new class(es) will appear there.
NOTE: Only students who are fully enrolled in the class will be imported. The Google Classroom API only returns official class members, so students who have been invited but haven’t accepted will not appear.
Keeping Rosters in Sync
The import is a one-time snapshot — PaperScorer doesn’t automatically reflect later changes in Google Classroom. If your roster changes later:
- A student joins the class in Google Classroom. From the class menu in PaperScorer, run the Google Classroom import flow again for the same class — new students will be added to the existing PaperScorer roster.
- A student leaves the class in Google Classroom. They won’t be auto-removed from PaperScorer. You can remove them manually from the class roster if needed; their existing scan history stays attached to them.
- A student’s name changes in Google Classroom. Re-importing the class roster will update the student record in PaperScorer to match the new name.
Edge Cases
A class is archived in Google Classroom after I imported it.
The PaperScorer class stays, and you can keep printing/scanning/grading for it. But the archived class will no longer appear in the “available classes” list for import, so you can’t re-sync the roster. If you need to refresh the roster, unarchive the class in Google Classroom first.
A student doesn’t have a school-issued email address.
The student will still be imported — we use the identifier Google Classroom provides. They’ll just lack an email on the PaperScorer record, which can limit features like email-based scan-result delivery for that student.
I imported the same class twice.
PaperScorer detects classes already imported from Google Classroom and updates the existing record rather than creating a duplicate. Students are matched by their Google Classroom ID, so re-importing won’t create duplicate student records either.
A student appears in PaperScorer twice — once from Google Classroom and once added manually.
This can happen if you added the student manually before importing the class. If the email addresses match, PaperScorer attempts to merge them at import time. If they don’t (e.g., the manual record used a different email), you can merge them yourself by editing one record to match the other, then deleting the duplicate.
I see a class in Google Classroom but it’s not in the import list.
Confirm three things in Google Classroom: (1) the class is active, not archived; (2) you’re a teacher/co-teacher, not just a student; (3) you signed in to PaperScorer with the same Google account that owns the class. If all three are true and the class still doesn’t appear, try disconnecting and reconnecting Google Classroom.