> 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/getting-started/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.
#### Before you begin
* Sign into Kita using your email and password or magic link.
* Your account has teacher permissions (**Tiers:** Teacher or Multiple Teachers).
#### 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.**"
* "I want to add students **to the school (individually & spreadsheet).**"
* "I want to to join Kita and enrol on courses **before a class session."**
{% 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: [https://getkita.io/*school*/join](https://getkita.io/login/join) \
Replace *school* with your school name–find this in your URL.
{% endstep %}
{% step %}
Students enter the code or if using the link the link is automatically entered. \
\
{% endstep %}
{% step %}
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.
{% 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
{% stepper %}
{% step %}
From the dashboard, click **Students** in the main navigation.
{% 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
{% stepper %}
{% step %}
From **Students**, select **Upload Student List**.
{% endstep %}
{% step %}
Download the template csv file for use with Microsoft Excel or Google Sheets.
{% 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.
{% endstep %}
{% step %}
Select **Finish.**
{% endstep %}
{% step %}
### Download student credentials
Select the students using the checkboxes.
{% endstep %}
{% step %}
Select **Download Credentials**.
{% endstep %}
{% step %}
Select the option to **Include passwords.** If you did not define your own passwords.
{% 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 %}
{% tab title="Setup before a class session" %}
> "I want to to join Kita and enrol on courses **before a class 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.
{% stepper %}
{% step %}
From the dashboard, click **Students** in the main navigation.
{% endstep %}
{% step %}
On **Students**, open the **Groups & Sub Groups** tab.
{% endstep %}
{% step %}
Click **Create**, then select **Create Group**.
{% endstep %}
{% step %}
Name the group and save. Students see this name when they join, so include the year and the subject.
{% hint style="info" %}
You can also add fellow co-teachers in this step.
{% endhint %}
{% endstep %}
{% step %}
To setup group course enrolments before a class session.
a. Select actions
b. Manage enrolments
{% endstep %}
{% step %}
Share your group **Join Code**
Send your group **join code** via email or school messaging services (e.g., Teams, VLE/LMS). Students can also use the code at:
{% hint style="info" %}
Group join codes expire after 1 week. You can turn off link expiry temporarily if needed. In the **Actions** menu for the group
{% endhint %}
The expiry date and time are shown underneath the code.
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}
#### Need help?
Email with your group name 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.getkita.org/getting-started/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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
