Rostering Students and Teachers for a Single School

To create teacher and student accounts, you can upload teachers.csv and students.csv (or just teachers.csv) directly to Literably. Literably will create teacher and student accounts based on the information in the files. Note that if you upload just teachers.csv, then teachers will add their own students once they login to Literably.

You can upload your files in 3 easy steps.

1. Download Blank Files

You'll need two files: teachers.csv and students.csv

(Students.csv is optional if you'd prefer to have your teachers add their own students manually.)

2. Complete the Files

Please do not remove the header row.

Note that teachers.csv must contain a complete list of all of the teachers who will be using Literably. Similarly, students.csv (if uploaded) must contain a complete list of all of the students who will be using Literably. If you upload incomplete files, Literably will infer that the teachers and students not included in the files are no longer using Literably.

Fields in teachers.csv

Teacher ID (required): teacher ID from your student information system. Must be unique across your district.
Title: Mr., Mrs., Ms., Dr., Miss, etc.
First Name (required)
Last Name (required)
Email (required) Must be unique.
Password (required) You can set the same password for all teachers.
School Admin: yes or no. Gives this user access to all students in the school. Use for principals, interventionists, etc.

Fields in students.csv

Student ID (required): student ID from your student information system. Must be unique across your district.
Grade (required): K, 1, 2, 3, etc.
First Name (required)
Last Name (required)
Teacher ID (required): must match a Teacher ID from teachers.csv
Secondary Teacher ID: enrolls the student in a second teacher's class. must match a Teacher ID from teachers.csv
Username: If you do not set student usernames, students will login by typing their teachers' email and picking their name from a list. If you set student usernames, each username must be unique across the district.
Password: If you set student usernames, then student passwords are required. You can set the same password for all students.
Initial Level: student’s initial A-Z reading level (can import DRA, F&P, STEP, and PM Benchmarks scores as long as the same system is used for all students). Only used for new students.
Level Imputed: optional true/false field (defaults to false). If false, will treat the supplied initial level as merely a guess and allow Literably to level a student below that level. Only relevant if Initial Level is supplied.
ELL: optional true/false field indicating English language learner status. Used in conjunction with home language for accent adjustments.
Home Language: optional home language code from your student information system. Used for accent adjustments for ELL students.


3. Upload the Files

A. Log in to Literably, click your username in the top right, and click Rostering.

If you do not see rostering, email for help.

B. Upload either teachers.csv (if you wish to have teachers add their own students) or both students.csv and teachers.csv. teachers.csv and students.csv must have exactly these filenames.

C. Within a few minutes, Literably will send you an email with the results. This email will indicate if there were any errors in the files. If errors were detected, correct the errors and re-upload. Note: If you upload teachers.csv and students.csv and there are errors in just one of the files, you must re-upload both teachers.csv and students.csv.


Files with duplicate usernames, emails, teacher IDs, or student IDs will be rejected.

Rows missing required fields will not be processed.

Rows assigning a student’s primary teacher to a user with no school will not be processed.

Usernames are case-insensitive.

Literably does not support associating teachers with multiple schools. If multiple schools are listed for a teacher, she will be associated with the first school.

If Literably can't find a teacher account with the given Teacher ID, but it does find a teacher account with the given email, the existing teacher account will be updated to reflect the information in the roster file.

Teacher and student credentials will be rewritten whenever these roster files are uploaded, even if these accounts already exist. The only exception is that we will not rewrite a teacher’s password, since sometimes teachers change these deliberately.

These files should be in standard CSV format (not Excel) with UTF-8 encoding and commas as delimiters. Quoting is required where there are commas in a field’s text, but is otherwise optional. The first row should be a header row consisting of column names, which should match the names of the fields in this document. 

Have more questions? Submit a request


Please sign in to leave a comment.