> 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/manage-your-tenant/classrooms.md).

# Organize classrooms

Classrooms group games and participants inside your tenant. Use them to separate courses, departments, cohorts, or terms. Each classroom has its own roster, games, settings, and analytics.

This page is for tenant managers and classroom managers.

## Before you start

* You need Tenant Manager access to create or delete classrooms.
* Classroom Managers can edit assigned classrooms but can't create new ones.
* Classroom limits depend on your tier (Free 3, Starter 10, Professional 50, Enterprise unlimited). To raise the limit, email <code class="expression">space.vars.support\_email</code>.

## Create a classroom

1. In the tenant dashboard, click **Add classroom**.
2. Enter a classroom name. The name must be unique within your tenant.
3. Add an optional description. Members will see it.
4. Click **Create**.

You'll land on the new classroom's page. The name and description can be edited later.

## Customize the appearance

In the **Class details** tab you can set:

| Field         | Recommended         | Where it shows                  |
| ------------- | ------------------- | ------------------------------- |
| Thumbnail     | 400x300 PNG or JPG  | Classroom listings              |
| Banner        | 1200x300 PNG or JPG | Top of the classroom page       |
| Primary color | Brand color         | Throughout the participant view |

Useful when you run several classrooms at once and want to tell them apart at a glance. Skip it if branding doesn't matter to you.

## Tag and link classrooms

* **Tags.** Add tags to filter and search classrooms. Common groupings: department, skill level, term, program type.
* **External IDs.** Link a classroom to an LMS course ID or student information system record for integrations.

## Pick an organization strategy

Most tenants organize classrooms along one or two dimensions. Pick the one that matches how you actually run programs.

| Strategy        | Example layout                                | Best for                                 |
| --------------- | --------------------------------------------- | ---------------------------------------- |
| By time period  | Fall 2024, Spring 2025, Summer 2025           | Schools and seasonal programs            |
| By audience     | Beginner, Intermediate, Advanced              | Multi-level training                     |
| By department   | Engineering, Sales, Executive                 | Corporate training                       |
| By program type | Weekly course, Summer intensive, Competitions | Mixed-format programs                    |
| Hybrid          | Fall 2024 - Beginner, Fall 2024 - Advanced    | Large programs that need cohort tracking |

## Configure access

Open the classroom's settings tab to control how people get in.

### Join link and password

Each classroom has a join URL and a password. Participants need both to enroll themselves. Share through email, your LMS, or a handout.

If credentials get over-shared, regenerate them. The old combination stops working immediately. Regenerating between enrollment periods is a reasonable routine.

### Visibility

| Setting  | Where it appears            | Use for                                       |
| -------- | --------------------------- | --------------------------------------------- |
| Public   | KC7 catalog and direct link | Open educational resources                    |
| Unlisted | Direct link only            | Internal training you don't want discoverable |
| Private  | Manual enrollment only      | Confidential training                         |

### Enrollment period

Set a start and end date to open and close enrollment automatically. After the deadline the classroom locks to new members even if they have valid credentials. Helpful for fixed-cohort programs where everyone should start together.

## Set defaults for new content

In the same settings tab you can set defaults that apply to new games and new members.

* **Game defaults.** Auto-assign behavior, default visibility, standard scoring.
* **Participant defaults.** Default role, welcome email, initial permissions.

## Manage at scale

### Copy a classroom

Duplicate the structure and games without participant data. Useful for recurring terms.

### Archive a classroom

Mark a classroom inactive while preserving all data and analytics. Reactivate later if you need to.

### Delete a classroom

{% hint style="danger" %}
Deleting a classroom permanently removes it. Participant data stays in any exports you've already taken, but the classroom itself is gone. Export data before deleting.
{% endhint %}

## Naming

Use descriptive names that include time period, audience, and program. The platform will let you name a classroom anything, but vague names hurt later when you have ten of them.

| Good                               | Avoid    |
| ---------------------------------- | -------- |
| 2024 Fall - Intro to Cybersecurity | My Class |
| Corporate Training - Q1 2025       | Test 123 |

## Match management to size

Bigger classrooms need different management.

| Size      | Approach                                                          |
| --------- | ----------------------------------------------------------------- |
| 1 to 30   | Single instructor, individual communication, real-time monitoring |
| 30 to 100 | Add an assistant, lean on structured channels and analytics       |
| 100+      | Multiple managers, automated tooling, tiered support              |

## Troubleshooting

**Participants can't find the classroom.** Verify the join link, check visibility, confirm the enrollment period is open, and make sure the password was communicated correctly.

**Wrong participants enrolled.** Check whether the join link was shared too broadly. Remove incorrect participants and regenerate the link.

**Classroom Manager can't access features.** Confirm the role assignment, check the classroom is the one they're assigned to, and confirm the change has propagated. Have them log out and back in.

## Next steps

* [Add games to a classroom](/manage-your-tenant/managing-games.md)
* [Add participants and co-hosts](/manage-your-tenant/managing-users.md)
* [Look up role permissions](/manage-your-tenant/managing-users.md#roles-and-permissions)
* [Review classroom analytics](/manage-your-tenant/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/manage-your-tenant/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.