In this guide, you’ll discover all the user roles available in Twig Science, understand the specific access and capabilities of each role, and learn how to roster them using your preferred method.
Step 1: Available Roles
District Administrator accounts are created by your Customer Success Manager (CSM). This role can not be rostered and must be provisioned. This role has district-wide access, including rostering and reporting tools.
School Administrator (referred to to as Administrator in rostering files) is assigned via your rostering data. Anyone in this role can manage users and view reports within their assigned school(s).
Teacher and Co-teacher roles are determined by rostering data. Teachers have access to their class roster, teacher instruction and student view.
Student roles are determined by rostering data. Students only see content assigned to them and can complete interactives and assessments.
Step 2: Understand each role’s access
Use the sections below to explore role access. Click to expand and see key permissions, tools, and special notes for each role.
District Administrators have the highest level of access across the platform. They can:
- Access the Twig Science platform and the Administrator dashboard.
- Browse all user data across the district.
- Access district-level assessment reports.
- Use rostering and SSO tools.
- View lessons (note: they cannot see student answers or assign lessons or assessments).
Note
District Administrator accounts are not rostered. District administrator credentials are provided to you by our support team.
Top tip
District Administrators can switch between the Admin dashboard and the Twig Science platform.
- When logged in to your admin account, use the side navigation bar to Switch to Elementary or Switch to Middle School.
- To switch back from Elementary, click the profile icon and click Administration.
- Switch back from Middle School using the left hand navigation bar. Click the arrow next to your name and select Switch to Admin View.
School Administrators (administrators) can:
- Access the grade view platform and the Administrator dashboard.
- Browse users and access reports for their assigned school.
- View lessons as a student on the Twig Digital book (without access to student answers or the ability to assign lessons or assessments).
Teachers and co-teachers have a classroom-level view and can:
- Access all subscribed grades, lessons, and assessments.
- Access all teaching aids such as teacher prep, lesson background, slides and glossaries.
- Assign lessons and assessments to students.
- Switch to student view to preview lessons as students would see them.
- Access student assessment reports for their classes.
- Teachers do not have access to district-level reports or district data.
Students have a dedicated view and can:
- Access lessons and assessments that have been assigned to them.
- Students do not see teacher dashboards or reports and cannot assign content.
Role comparison matrix
Here’s a quick comparison of the access levels for each user role in the Twig Science platform. This table gives an at-a-glance view of what each role can see and do.
| Role | Student view | Teacher view | Assigning lessons & assessments | Student assessment reports | District assessment reports | District data browser | Roster & SSO tools |
|---|---|---|---|---|---|---|---|
| Student | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
| Teacher | ✓ | ✓ | ✓ | ✓ | ✗ | ✗ | ✗ |
| Co-teacher | ✓ | ✓ | ✓ | ✓ | ✗ | ✗ | ✗ |
| Administrator | ✗ | ✓ | ✗ | ✓ | ✓ | ✗ | ✗ |
| District Administrator | ✗ | ✓ | ✗ | ✓ | ✓ | ✓ | ✓ |
Step 3: Roster each role
Choose your rostering method:
Follow Clever’s or Classlink’s own documentation to map these Twig roles to your SIS roles:
Role is assigned within two different files when using One Roster format. The role of a user is assigned in the user.csv and the enrollments.csv.
We’ll look at how to roster the following user types:
- How do I roster different roles using One Roster files?
- How do I specify the difference between teacher or co-teacher using One Roster files?
How do I roster different roles using One Roster files?
The role of teacher, student or school administrator is assigned in both the enrollments.csv and the users.csv.
Enrollments.csv
Users.csv
How do I specify the difference between a teacher or co-teacher using One Roster files?
To make a teacher a primary teacher or co-teacher open the enrollments.csv. Here you need to mark a teacher as TRUE in the Primary column, and to assign the role of co-teacher either leave the field empty or mark as FALSE.
For a full guide to rostering with One Roster please read: Rostering with CSV One Roster format
To roster users with Twig Science Format (TSF) you need to provide two CSV files, a user.csv and a classes.csv. These can be uploaded to the platform by using your district administrator credentials.
We’ll look at how to roster the following user types:
- How do I roster a student using TSF files?
- How do I roster a teacher or co-teacher using TSF files?
- How do I roster a school administrator using TSF files?
How do I roster a student using TSF files?
To roster students you need to add them to the user.csv file and type in student in the role column.
Students also need to be added to the classes.csv where they can be attached to a teacher and class.
For a full guide for how to roster using TSF files please read: Rostering manually with Twig Science Format.
How do I roster a teacher or co-teacher using TSF files?
To roster teachers or co-teachers you need to add them to the user.csv file and type teacher in the role column.
Teachers also need to be added to the classes.csv where they can be attached to a class.
To add a co-teacher to a class, you will need to add them to the classes.csv file after the primary teacher’s class rows. Using the example below, teacher T001 teaches class KG_1B with 5 students, a co-teacher, CO-T002, has been added with the same class and student associations immediately below.
Top tip
You can copy the rows containing the primary teacher associations (rows 2-6), paste it in the next available rows (rows 7-11) replacing the teacher_id value with the co-teacher’s teacher_id value.
How do I roster a school administrator using TSF files?
To roster school administrators you just need to add them to the users.csv file and type administrator in the role column. School administrators do not need to be added to the classes.csv file. Assign their school by adding the name of the school in school_names column.