Skip to content

Teacher Users

Teacher accounts in TKG Analytics are provisioned exclusively from your SIS export. There is no UI invite path for teachers. By design, the teacher roster has to stay in sync with enrollments, schedules, and score attribution, all of which come from the SIS.

For district and school users, see District & School Users and Inviting Users.

Why teachers come from a file

Every teacher in TKG Analytics has a Teacher record that score attribution, enrollments, and impact reporting depend on. That record is built from your SIS, the same source that produces enrollments.csv and schedules.csv. If a teacher were created via UI invite, their login would exist without a matching Teacher record, and their scores / classes / students wouldn't surface anywhere.

Pinning teacher provisioning to the SIS export keeps the instructional roster and the login roster aligned automatically.

How it works today

One file does both jobs. teachers.csv builds the Teacher record and the login:

Creates From
Teacher record, used for score attribution, enrollments, and impact reporting Every row with teacher_id, school_id, first_name, and last_name
User + AccountUser with the teacher role, the login itself Every row whose teacher_id matches a Teacher record and whose email is on your district's staff domain

A row missing school_id is not fully imported

school_id is required to build the Teacher record but not the login. A teacher new to TKG Analytics on such a row gets neither a Teacher record nor a login, because a login with no Teacher record behind it has nothing to report on. A teacher already in TKG Analytics still has their login refreshed by that row, but their Teacher record is left inactive for the sync and nothing about it is updated, so they stop appearing in reporting until a complete row arrives.

A row missing first_name or last_name deactivates the login

Both imports require these columns, so the row is skipped by the Teacher import and the login import. For a teacher already in TKG Analytics, the sync deactivates the login before reading the row and the skipped row never reactivates it: they cannot sign in until a complete row is uploaded. Their Teacher record is left inactive the same way. If a teacher loses access overnight, a row missing a name is the first thing to check.

There is no separate teacher users file. teachers.csv is the single source for both, so a teacher appears once and their instructional record and their login can no longer drift apart.

The email column is required, even though individual values may be blank

Because this file provisions logins, it must carry an email column. That is a requirement of the column, not of every row: a teacher who will never sign in can have a blank value. On the onboarding Current SIS Files step a teachers.csv with no email column is refused as you upload it. The Historical SIS Files step does not require it, because the prior-year file builds Teacher records only.

Teachers whose email is not on your staff domain

A row whose email is outside the staff email domain configured for your district gets a Teacher record but no login. This is deliberate: the staff domain is what your district has declared its own, and an automated import does not create accounts outside it. A row with no email at all is treated the same way. If a teacher needs access on a different address, submit a Helpdesk Ticket.

See SIS Data Format for the full column list.

Updating the teacher roster

  • Add a teacher: add a row to teachers.csv. Re-upload via SIS Data Upload or wait for the nightly sync. If the row carries an email on your staff domain, they get a login at the same time.
  • Remove a teacher's login: clear the email on their row, or change it to an address outside your staff domain. They keep their Teacher record for historical reporting and lose the ability to sign in.
  • Remove a teacher entirely: drop the row. Historical scores attributed to that teacher_id are preserved.
  • Edit teacher details (name / email / title): edit the row and re-upload. The values in the new file win on import.

Deprovisioning is automatic. Any teacher_id missing from the next CSV import is deprovisioned for that role scope. To restore access, re-include them in a future CSV.

SIS Query Support

Need help pulling teacher rosters from your SIS? We provide queries and step-by-step export instructions for the common Mississippi SIS platforms.

Need Help?