All Collections
ClassTag Connect API Integrations
How do I sync my ClassTag Account using OneRoster?
How do I sync my ClassTag Account using OneRoster?
Alex Karl avatar
Written by Alex Karl
Updated over a week ago

ClassTag Connect offers roster synchronization and single sign-on (SSO) with Clever and ClassLink.

Alternatively, districts and schools can set up roster synchronization by pushing OneRoster-formatted CSV files from their student information system (SIS) via secure file transfer protocol (SFTP) to ClassTag, or manually upload OneRoster-formatted files on ClassTag.

ClassTag Sync is only available to ClassTag Connect customers. Please contact our Support Team at if you are interested in upgrading your ClassTag Account.

If your school or district is already using ClassTag Connect, please follow the steps below to set up SFTP roster synchronization.

1. Prepare an SFTP folder

In order to set up an automated SFTP sync, you need to have an SFTP folder to drop OneRoster-formatted CSV files. You can use a folder on your site or, if you don’t have one, ClassTag support will be happy to give you access to our site. Please let us know the option you prefer at

2. Send OneRoster CSV files to the SFTP folder

Please upload the following OneRoster files to the SFTP folder:

  • users.csv

  • classes.csv

  • enrollments.csv

If it is easier for you to upload a ZIP archive with OneRoster CSV files, that’s also supported. ClassTag will automatically extract the necessary files before processing.

Please double-check the contents of your files and make sure that you’re not oversharing data with ClassTag.

3. Match ClassTag schools with OneRoster schools

Please add School IDs to existing schools on ClassTag to match them with the schools in your OneRoster data. Please click here to know more about how to add School IDs to existing ClassTag Schools.

4. Update existing ClassTag classrooms

If you already have pre-existing classrooms in your ClassTag account prior to your OneRoster sync, similar to matching ClassTag Schools with OneRoster schools, you can also sync existing Classrooms with OneRoster Classrooms. Please click here to see other options or how to sync the Classrooms.

5. Modify sync settings

Adjust ClassTag sync settings to make sure they meet your needs. Please click here to see more information.

6. Self-Check

Please review everything again to ensure all is set up as desired. Open this article to know more about what else you have to check and consider before enabling the sync.

7. Enable and launch the sync

Enable the sync and save settings when you’re ready. Please click here to see how.

8. Check the sync results

After the sync is complete, please check the sync reports to verify that staff, students, classrooms, and parents/guardians are added to the District and School Directories and Classroom pages.

9. Clean up student data.

There are two main parts to cleaning up the student data. They are:

  • Archiving students who are not part of the sync.

  • Merging student duplicates. It helps to have all student data (announcements, backpacks, interaction logs, student attributes, other) linked to a single student vs spread across multiple students.

If you only sync one school, please archive students from the School Directory.

If you sync all schools in your district, you can archive students from the District Directory.

If you sync some but not all schools in a district, please archive students from a School Directory, and then repeat it for every syncing school.

You can feel free to select and archive all students in Directory. If your sync is enabled, the sync-managed students won't get archived. Meaning that you'll only archive students who are not part of the sync.

Please see this article for more information on how to archive students.

To merge student duplicates, please follow the steps in this article.

You are all set once all 9 steps are completed! Please do not hesitate to reach out to our Support Team at if you experience any issues or have any questions related to these steps.


Did this answer your question?