SaaS Documentation Has Moved: Documentation for Relay, Mobile Manager, and Classroom will no longer be updated on the Community Site and has moved to our Intercom Help Center. This move allows us to provide in-app documentation for our SAAS platform. SAAS documentation can now be found here. Note: Longhorn/Web Filter documentation will continue to be available on the Community Site.


Lightspeed Dashboard: User Import

A user data file will add or update user accounts. This file MUST be named either users.csv or users-v2.csv. Files with any other name, case, or extension will be ignored. There is no functional difference between these two files. However, if both files are present, only users-v2.csv will be processed.

Note: users-v2.csv files must contain headers with the specific column Field Names (all lowercase) below.

Create the users.csv or users-v2.csv file

Column Field Name Description Note
A unique_sis_user_id Unique ID of the user in your SIS. Must be unique within the entire district required
B username The user’s login name. For users authenticating with an auth source on your Rocket, this should be their network username and must be unique to the district. required
C first_name First name of the user required
D last_name Last name of the user required
E unique_sis_school_id The SIS ID for each school, which must be unique within your district. required
F grade Grade level is optional unless you need to filter Campus Library items by grade level, or set restrictions policies in Mobile Manager by grade level. United States Student grade level or year (1 through 12) Use 0 (zero) for Kindergarten, and -1 (minus one) for Pre-Kindergarten. United Kingdom – Student year (1 through 12). Use -1 (minus one) for Reception, 0 for Year 1, 1 for Year 2, etc.For example:Reception- -1
Year 1- 0
Year 2- 1
Year 3- 2…
Year 13- 12
G email Email address where the user can receive notifications, messages, and alerts. required
H user_type student: 1
staff: 2
If left blank, the default user type student is used.
I password Only needed for users not authenticating with your Directory service or GAFE domain Optional*
J authentication 0 = Directory Service authentication, 1 = Local authentication Recommended*

*Password option: When authenticating user logins without a Rocket server (option “1” in Column J), you must enter a password in Column I.


Column A Column B Column C Column D Column E Col. F Col. G Col. H Col. I Col. J
unique_sis_user_id username first_name last_name unique_sis_school_id grade email user_type password authentication



Sample Users CSV Files


Note: The import files must be named correctly or they won’t be imported.
Note: CSV files must be encoded as “UTF-8 without BOM”. There can be no spaces between each line.