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.
(Note: these instructions are designed for a manual roster upload. If your district is automating the process, then do not use these instructions. In these cases, we accept a different format called oneRoster. Use our oneRoster guide.)
You can upload your files in 3 easy steps.
1. Download Blank Files
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.
If rostering multiple schools:
School: school name. Required for single-school users (teachers, principals, etc.). For admins managing multiple schools, separate the names of the schools by commas. Leave blank for district-level personnel.
District Admin: yes or no. Gives this user access to all students in the district. Use for district administrators.
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. Only used for new students.
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 firstname.lastname@example.org 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.