Twig: Available User Roles

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 School Administrator Teacher Student

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.

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 Administrator

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.

  1. When logged in to your admin account, use the side navigation bar to Switch to Elementary or Switch to Middle School.switch.png
  2. To switch back from Elementary, click the profile icon and click Administration. return from elementary.png
  3. Switch back from Middle School using the left hand navigation bar. Click the arrow next to your name and select Switch to Admin View.admin view.png
School Administrator

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).
Teacher

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.
Student

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:

Roster via Clever or Classlink

Follow Clever’s or Classlink’s own documentation to map these Twig roles to your SIS roles:

Roster via One Roster files

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?

The role of teacher, student or school administrator is assigned in both the enrollments.csv and the users.csv.

Enrollments.csv
Image 24-10-2022 at 14.28 (1).png

Users.csvImage 24-10-2022 at 14.33.png

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.
Image 24-10-2022 at 14.41.png

For a full guide to rostering with One Roster please read: Rostering with CSV One Roster format

Roster via Twig Science CSV (TSF)

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?

To roster students you need to add them to the user.csv file and type in student in the role column.Image 24-10-2022 at 15.18.png

Students also need to be added to the classes.csv where they can be attached to a teacher and class.Image 24-10-2022 at 15.21.png

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.

Image 25-10-2022 at 11.53.png

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.Image 25-10-2022 at 11.55.png

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 columnImage 25-10-2022 at 11.59.png

Back to Top