> For the complete documentation index, see [llms.txt](https://docs.getkita.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getkita.org/set-up-your-class/add-your-students-to-kita.md). # Add your students to Kita Get your students onto Kita and ready to start coding. *** Kita is designed to get your students coding as quickly as possible. We have based this guide on typical teaching scenarios. The video below outlines your options, the same information is also broken down in the scenarios below. {% embed url="" %} #### Before you begin * Sign into Kita using your email and password or magic link. * Your account has teacher permissions (**Tiers:** Teacher, Multiple Teachers, School). #### Add your students: scenarios Use the tabs below, based on your scenario. * "I am live teaching and I want students to **join my course now.**" * **Recommended:** "I want to to join Kita and enrol on courses **before a teaching session (set up your class)."** * "I want to add students **to the school (individually & spreadsheet).**"
{% tabs %} {% tab title="Join my course now" %} > "I am live teaching and I want students to **join my course now.**" All courses have a **join code** which refreshes every 30 minutes. This can be used to: * Enable students to join Kita and go straight into the course * Get students who have accounts logged in and into the course ### Use the Join Code {% stepper %} {% step %} Go to **Courses** and click on the **Join Code** for the course card
{% endstep %} {% step %} Share the join code onscreen in the room. Click on the code to copy it.
{% endstep %} {% step %} Ask your students to go: \ \ [**getkita.io/join**](https://getkita.io/login/join)
{% endstep %} {% step %} Students enter the code or if using the link the link is automatically entered. \
{% endstep %} {% step %} When the code is recognised the students are shown two options. Select the option that applies: 1. **I'm new:** new students are asked for their First name and Last name and then given a temporary password to save. They are asked to reset their password at the end of the classroom session. 2. **I have a Kita login:** allows existing students to login and go directly into the course.
The code has been entered at getkita.io/join and the student is selecting 'I'm new'.
{% endstep %} {% step %} The student will be asked for a first name and last name. If you prefer students use a pseudonym or firstname plus initial, those will be accepted. {% hint style="info" %} To use Microsoft and Google, Kita needs to be approved by your school IT department unless non-school accounts are used (e.g., personal tutors using Kita). Please get in touch: {% endhint %}
The student has added a first name and last name to the setup screen.
{% endstep %} {% step %} The student needs to copy their username and select 'Join course'. They will then be taken directly into the course and lesson.
The student is copying their username and then they will join the course.
{% endstep %} {% step %} ### At the end of your teaching session If you have used direct sign-up, encourage students to log out, they will be given an option to reset their password to whatever they prefer. Students select their avatar on the bottom-left to log out of their account.
Time2Code Level 1 is shown in the Kita IDE and the student is logging out from their avatar on the bottom-left.
{% endstep %} {% endstepper %} {% endtab %} {% tab title="Setup before a class session" %} > "I want to to join Kita and enrol on courses **before a teaching session.**" Use this method if you would like to set up your class in advance. This is especially helpful when you want students to **join Kita and enrol on multiple courses** in one step.
Shows annotated screenshot of the Students area on the Classes & Subgroups tab. The mouse is selecting Create then Create class.
{% stepper %} {% step %} From the dashboard, click **Students** in the main navigation. {% endstep %} {% step %} ### Create your class Click **Create**, then select **Create class**. {% endstep %} {% step %} Name the class. {% endstep %} {% step %} Optional: add a short name \ *This is handy for spreadsheet exports if you have a long class name.* {% endstep %} {% step %} Optional: Add the Year, if applicable. {% endstep %} {% step %} Optional: Add a description for fellow teachers. {% endstep %} {% step %} Select **Create class & continue.**
Shows the first page of the Create class wizard, including steps 3 to 7 as outlined on this page.
{% endstep %} {% step %} ### Add teachers If you share teaching with a colleague you can add them to the class or use **skip for now** to move to the next step.
Shows adding a teacher by clicking the tick box on the right of their name.
When you've added your colleagues, select **Continue to enrolments.** {% endstep %} {% step %} ### Add course enrolments Select the courses that you would like to students to join. {% hint style="info" %} You can filter by year (educational level) to find courses. {% endhint %}
Two courses have been selected using the checkboxes. The mouse is selecting 'Continue to students'.
{% endstep %} {% step %} ### Add students You have **three options** for adding students that you can use **separately or in combination**.
Option A is to invite students with a join link, option B is to import students via CSV, option C is to add existing students.
a) **Invite students using the Course Join link.** \ This is ideal for use in Microsoft Teams or Google Classroom. \ \ Use **set link expiry** to set your own date and time or set to **never expires**.
b) **Import students via CSV** \ Use this method you would like to upload student names and then download temporary passwords for use in class. Use our Template CSV to provide your list in the correct format. Once you have uploaded your sheet, select **Add students to class**.
Mouse is shown pointing to the download template CSV. This will download an Excel template for the teacher to complete with student information.
c) **Add existing students** \ Use this method to create a class from students who are already on your Kita school.
The mouse is shown selecting a student name for inclusion in the class.
{% endstep %} {% step %} Once you have finished adding students and/or have copied the class join code. Move on to the final stage: **Review current members**.
The mouse is shown selecting the 'Review current members' option, to move on to the final step.
{% endstep %} {% step %} ### Review current members The final step give you an overview of your class including teachers and students.
Shows the list of teachers and students on the course. The mouse cursor is pointing to Finish setup.
{% endstep %} {% step %} ### Update your class You can update your class from the three dots, action menu on the right of your created class. Your join link is always available from this screen. * **Edit class details** \ Provides the same setup wizard screens outlined above. * **Manage class** \ Allows to you to quickly revise your class membership and add more students as needed.
Select the three dots on the right of the group to manage the options.
{% endstep %} {% endstepper %} {% endtab %} {% tab title="Add students to the school" %} > "I want to add students **to the school (individually & spreadsheet).**" ### Add an individual student to the school
Screenshot shows the Students page with the Manage Students tab selected, with the option to Add Individual Student selected.
{% stepper %} {% step %} From the dashboard, click **Students** in the main navigation. {% endstep %} {% step %} Select **Manage Students.** {% endstep %} {% step %} Select **Add Student.** {% endstep %} {% step %} Select **Add Individual Student.** {% endstep %} {% step %} Complete the form for the student and set whether the student is over 13. If the student is under 13 confirm parental permission. {% endstep %} {% step %} Select **Save**. {% endstep %} {% endstepper %} ### Add multiple students using a spreadsheet
On the students page, add student then upload student list has been selected.
{% stepper %} {% step %} From **Students**, select **Upload Student List**. {% endstep %} {% step %} Download the template csv file for use with Microsoft Excel or Google Sheets.
In the upload area for adding a list, Download template CSV is being selected.
{% endstep %} {% step %} Prepare and upload a CSV file with one row per student, using these column headings. ```csv First name,Last name,Temporary password Alex,Carter, Jordan,Lee, ``` {% hint style="info" %} You can define a temporary password, or leave it blank for Kita to assign temporary passwords. {% endhint %} {% endstep %} {% step %} Upload the completed CSV file. If you encounter errors check the row identified in the status (as indicated). Lookout for non-character spaces after a names or column titles.
In the upload area for the list an arrow points to the status showing valid rows in the sheet.
{% endstep %} {% step %} Select **Finish.** {% endstep %} {% step %} ### Download student credentials Select the students using the checkboxes.
The Students page is shown and the students have been selected. The option to Download Credentials is shown at the bottom of the screen.
{% endstep %} {% step %} Select **Download Credentials**. {% endstep %} {% step %} Select the option to **Include passwords.** If you did not define your own passwords.
The option to include passwords is selected and download is shown as step 9
{% endstep %} {% step %} Select **Download.** {% endstep %} {% step %} Use the downloaded spreadsheet to tell your students their usernames and temporary passwords in class. \ \ Students will be asked to reset their passwords when they login for the first time. {% hint style="info" %} If students forget their password, Teachers can reset at any time from the **Students** page. {% endhint %} {% endstep %} {% endstepper %} {% endtab %} {% endtabs %} #### Need help? Email with your class name and school or book a support call for help with setup. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.getkita.org/set-up-your-class/add-your-students-to-kita.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.