> For the complete documentation index, see [llms.txt](https://docs.kc7cyber.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kc7cyber.com/dashboard/classrooms.md).

# Organize Classrooms

Classrooms group games and students inside your dashboard. Use them to separate courses, cohorts, workshop groups, or terms. Each classroom has its own games, roster, leaderboard, and settings.

Every dashboard starts with a default classroom named **My First Classroom**. You can rename it to anything in its settings, and many organizations run happily on that single classroom for a long time.

## The Classroom Screen

Open a classroom from the **Classes** section of the sidebar. Every classroom has the same five tabs, with a **Join link** button and an **Add game** button always available in the header.

| Tab             | What it holds                                                                                                                                             |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Home**        | The at-a-glance view: quick actions, stat tiles (students, games assigned, average completion, needs attention), and a list of students who've gone idle. |
| **Games**       | Every game assigned to this classroom, with visibility controls and per-game join codes. Covered in [Manage Games](/dashboard/managing-games.md).         |
| **Roster**      | The progress matrix (every student crossed with every game) plus the tools for adding students.                                                           |
| **Leaderboard** | Students ranked by points across the classroom's games.                                                                                                   |
| **Settings**    | Name, description, enrollment controls, classroom managers, and deletion.                                                                                 |

## Create a Classroom

Two paths to the same place:

* In the sidebar, click **New class** under your classroom list.
* Or open your dashboard's **Classrooms** tab and click **Add Classroom**. This tab also lists every classroom with its game and student counts, and it's where you manage the full set as you grow.

Give it a name and an optional description, and you'll land in the new classroom ready to add games.

## Classroom Settings

The **Settings** tab has four sections.

**Details.** The classroom's name, description, and an optional thumbnail image. This is also home to the **invite-only enrollment** toggle: when it's on, only people you invite by email can join, and the shareable join link, self-registration, and guest accounts are all blocked for anyone you haven't invited. Turn it on for closed cohorts where you control the exact roster; leave it off for open workshops where a shared link is the point. Click **Update** to save changes.

**Classroom Managers.** Give someone admin access to this classroom without giving them your whole dashboard. Good for co-teachers and volunteer helpers. Roles are covered in [Manage Users](/dashboard/managing-users.md).

**Tenant Info.** A reference card for the dashboard this classroom belongs to.

**Danger Zone.** Deletion lives here, deliberately out of the way.

{% hint style="danger" %}
Deleting a classroom is permanent. Export anything you need from its analytics first.
{% endhint %}

## Get Students In

The **Roster** tab has an **Add students** panel with three methods: invite by email (paste addresses, send invites, and track them under pending invitations), share the join link, or add people who already have accounts in your dashboard. The full walkthrough, including advanced management for removing students and bulk password resets, is in [Manage Users](/dashboard/managing-users.md).

## Watch the Room

The **Home** tab tells you how the classroom is doing without any digging: student count, games assigned, average completion, and a **Needs attention** list of students who've gone idle, with how long they've been away.

The **Roster** tab goes deeper with the progress matrix: every student crossed with every game, each cell colored by progress (complete, on track, started, just began, not started, stuck) with week-over-week movement indicators. Every cell is clickable, jumping to that student's per-challenge drilldown or letting you assign a game on the spot.

For analytics across your whole organization, see [Track Performance](/dashboard/analytics.md).

## When to Split Into Multiple Classrooms

One classroom is right until it isn't. Common reasons to split:

| Strategy       | Example layout             | Best for                      |
| -------------- | -------------------------- | ----------------------------- |
| By time period | Fall 2026, Spring 2027     | Schools and seasonal programs |
| By audience    | Beginner, Advanced         | Multi-level training          |
| By group       | Engineering, Sales         | Corporate training            |
| By format      | Weekly course, Competition | Mixed-format programs         |

Whatever you pick, use names that will still make sense when you have ten of them. "2026 Fall - Intro to Cybersecurity" ages better than "My Class."

## Troubleshooting

**Students can't join.** Check whether invite-only enrollment is on (it blocks the join link for anyone not invited by email), and confirm you shared the current classroom join link.

**A manager can't see the classroom.** Confirm they're assigned under Settings, Classroom Managers, and that they're looking at the right classroom. Have them log out and back in if a fresh assignment isn't showing.

**Wrong people joined.** The join link traveled further than intended. Remove them via the roster's advanced management, and consider invite-only enrollment for the rest of the term.

## Next Steps

* [Add games to a classroom](/dashboard/managing-games.md)
* [Add students and co-hosts](/dashboard/managing-users.md)
* [Review progress and analytics](/dashboard/analytics.md)


---

# 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.kc7cyber.com/dashboard/classrooms.md?ask=<question>&goal=<endgoal>
```

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