Skip to content

Frequently Asked Questions

Here you can find answers about the algorithm, settings, usage, and the project.

What seating plans can achieve – and what they can't?

Klassenplan is a tool to support your teaching practice, not a replacement for it. Research shows that seating arrangements have a small but measurable effect on learning behavior.

For context: Hattie (2009, Visible Learning) reports an effect size of d ≈ 0.1–0.2 for seating arrangements, while e.g. direct feedback (d ≈ 0.73) is considerably more impactful. The seating plan is one piece of the puzzle.

The seating plans created by Klassenplan are starting points, not finished solutions. Your pedagogical assessment is decisive.

General Questions

Overview of algorithm, privacy, and offline usage.

What does the mixing algorithm actually do?

+

The algorithm distributes your class to all available seats based on weighted criteria. It starts with a heuristic initial placement and refines it in several passes. It takes into account preferred and distant partners, special needs, body heights, window/door preferences & more.

How does the algorithm evaluate neighbors?

+

There are three gradations of neighborhoods that are weighted differently:

  • direct neighbors (highest weight)
  • side neighbors (medium weight)
  • neighbors across/opposite (lower weight)

These gradations help to represent free layouts as realistically as possible and to avoid conflicts in a targeted way.

Do I need an account or internet?

+

No. Klassenplan runs completely locally (IndexedDB + localStorage) and works offline after the first load. There is no login and no cloud synchronization. For device or browser switching, use the backup export/import.

Why doesn't the algorithm work "perfectly"?

+

The algorithm evaluates table groups in the context of the entire room. A swap can help in one place but create bigger conflicts elsewhere. A perfect solution would have to check every combination and would not be practical. With its heuristic approach, Klassenplan achieves fast, comprehensible results that you can further refine via drag & drop.

Class list & class management

Multiple classes, CSV import, photos and bulk editing.

Can I manage several classes?

+

Yes. The class manager in step 1 lets you create as many classes as you like, rename them and switch between them. Each class keeps its own students, classroom layouts, seating plans and shuffle history. Deleting a class also removes its seating plans – so a backup beforehand is worth it.

How do I import an existing class list?

+

Use "Import class list" to upload a CSV file, the kind you can save from Excel, LibreOffice, Numbers or Google Sheets. A list from your school administration software – WebUntis, Schulmanager or SchILD, say – can usually be uploaded as it is: Klassenplan recognises the usual column names, reads accented characters correctly even when the file was saved on Windows, and skips a title line above the headers. The only requirement is a name column – "Name", "First name" or "Last name"; every other column such as gender, restless, window seat or preferred partner is optional, and unknown columns are simply ignored. Click "What the file looks like" to see an example, or download the CSV template and fill it in. If your file contains several name columns or several classes, Klassenplan asks what to import.

Can I store photos of my students?

+

Yes, via the portrait icon next to each student. The images are downscaled and stored exclusively on this device – they are never transmitted. Using student photos requires the consent of your school management, the students and their parents. Photos can be shown or hidden in the seating plan, in presentation mode and in the export, and they unlock the name game, an easy way to learn the names.

How do I edit several students at once?

+

Use the checkboxes in the list to select several students and set gender, height, language level, social role or individual markers for all of them together. Search, filters (e.g. "Without photo" or "Restless only") and sorting help you get to the students you want to edit quickly.

Can I undo changes?

+

Yes, Klassenplan finally supports undo and redo everywhere. In the class list, the classroom editor and the seating plan/seating circle editor alike you can take changes back and restore them – so an accidentally deleted student comes back together with their photo, for example. Tip: use the shortcuts Ctrl / Cmd + Z and Ctrl / Cmd + Shift + Z to undo or redo changes.

Can I try Klassenplan without real student data?

+

Yes. Choose “Load sample class” in step 1 – right below “New Class” as long as you have no class yet, otherwise in the “Add” menu. Klassenplan then creates a separate class with 24 invented students, drawn portraits and a furnished classroom; your other classes stay as they are. If the sample class already exists, the same button takes you to it – to start afresh, delete it and load it again. You can try every step without risk and simply delete the sample class afterwards from the class switcher.

Student Properties & Criteria

Overview of all properties and how the algorithm uses them.

In Step 1, you can set various properties for each student. These flow into the seating plan calculation in Step 3. Here you'll find an overview of all properties, what they mean, and how the algorithm considers them.

PropertyDescriptionAlgorithm Effect
Identity
Gender
Male, female or diverse – optional information.Creates gender-mixed table groups when enabled.
Height
Small, Medium, or Tall – affects seating row.Places smaller students at the front and taller ones at the back for clear sightlines.
Abilities
Language Skills
From native speaker to ESL support.Pairs language-strong students with beginners for mutual support.
High Performer
Currently showing particular strengths in class.Enables heterogeneous (peer tutoring) or homogeneous grouping.
Needs Support
Currently showing additional support needs in class.Enables targeted pairing with high-performing students.
Front seat
This student needs a front seat.Places this student preferably in the front rows.
Behavior
Restless
Currently showing restless behavior in class.Separates students with restless behavior from each other.
Shy
Currently showing reserved behavior in class.Places students with reserved behavior next to quieter classmates.
Easily Distracted
Currently showing concentration difficulties in class.Distributes students with concentration difficulties in the room and separates them from students with restless behavior.
Social
Social Role
Mediator, Leader, Loner, or Social Hub.Distributes social roles evenly across tables for balanced group dynamics.
Preferred Partner
Up to 3 prioritized partners the student wants to sit with.Places preferred partners at the same table, priority 1 counts more.
Distance Request
Up to 3 students to keep distance from.Places these students at different tables.
Room Preferences
Window Seat
Prefers a seat by the window.Places the student closer to the window when possible.
Near Door
Prefers a seat near the door.Places the student closer to the door when possible.

Preferred & Distant Partners

How preferred partners, distance wishes, and special needs influence the calculation.

How do multiple preferred and distant partners work?

+

You can select up to 3 preferred and distant partners per student. The order determines the priority – the first selected partner is weighted more heavily than the third. The algorithm tries to fulfill as many wishes as possible, with Priority 1 taking precedence.

Are preferred partners always considered?

+

If you activate "Consider preferred partners", the algorithm places pairs together unless other rules speak against it. At group tables (4/6), a seat at the same table counts as partially fulfilled.

How does the system handle restless behavior, concentration difficulties, and distance wishes?

+

There are separate weights for restless behavior, concentration difficulties, and distance wishes. Students with restless behavior are separated from each other, students with concentration difficulties are distributed in the room, and distance wishes are respected as long as enough seats are available.

How does Klassenplan consider body heights and room preferences?

+

Body heights feed into the seat selection so that smaller students are placed as far forward as possible. Window and door preferences are saved per student and weighted together with the room elements you positioned in step 2.

Seating Plan Structure & Layout

Notes on table layouts, room elements, seat distances, and limits.

Which layouts work best?

+

Let your creativity run free: you can place tables, windows, doors, desk and blackboard anywhere via drag & drop. The seating circle remains synchronized with the table layout and can be adjusted separately.

How are distances measured?

+

Seat positions are stored as pixel coordinates. Direct neighbors lie within the table width and height plus buffer; side and frontal neighbors may be slightly further away until they are no longer considered relevant.

Are there limits on students and seats?

+

Yes. Klassenplan is designed for a maximum of 36 students. The system warns if fewer seats than students are available.

Settings & Weighting

How to interpret the weights and the statistics panel.

What do the weights (0–10) mean?

+

The weights define how strongly a rule influences the result. The higher the value, the more strongly suitable neighbors are rewarded or conflicts punished. A value of 8 prevails significantly more often than a value of 2.

How do I recognize that a mix meets the criteria?

+

The statistics panel in step 3 shows gender distribution, room preferences (window/door), distance wishes and other criteria, for example.

What do the colors in the statistics panel mean?

+

The traffic light colors show the degree of fulfillment:

  • Green – well fulfilled (over 80%)
  • Yellow – partially fulfilled (50–80%)
  • Red – improvable (under 50%)

How are percentages calculated for multiple preferred partners?

+

Each preferred partner counts individually in the statistics:

  • Direct neighbor = 100% fulfilled
  • At the same group table (4/6) = 50% fulfilled
  • Different table = 0% fulfilled

Example: 3 partners, 1 adjacent (100%) + 1 at table (50%) + 1 elsewhere (0%) = (100+50+0) / 3 = 50%

What happens when clicking or hovering over the statistics panel?

+

You can click a category to permanently highlight the students it affects in the seating plan. Hovering shows a temporary preview of that highlight. This lets you quickly recognize which placements could contribute to improving the mix result.

How does repeat avoidance work?

+

The repetition evaluation considers both saved seating plans and the current mix history of the session:

  • Saved plans: Pairs from older plans receive decreasing weight (newer ones count more)
  • Current Session: The last mixes are weighted more heavily so that pairs do not repeat immediately

This avoids the same students sitting next to each other constantly when you shuffle several times in a row. Not every shuffle is actually put into practice, though – and that is exactly where the mix history on its own reaches its limits.

Klassenplan therefore keeps track of which seating charts were really in use. There is nothing to tick – what counts is what you do anyway:

  • Showing a seating chart in presentation mode
  • Printing a seating chart or exporting it as PDF, PNG or SVG
  • Saving a seating chart under a name you chose yourself
  • Swapping seats by hand

Only the seating neighbourhoods and a timestamp are stored, entirely on your own device – no cloud, no analytics service. On the first strong signal a short notice asks: if it really was just a test, one click takes the chart back out of the count.

For repeat avoidance these real seating charts are read first; mixes from the running session now weigh only half as much. A long session of trying things out can no longer drown out the result.

Under "Plans, mixes & neighbourhoods" (footer or step 3) the "Neighbourhoods" tab shows who has sat next to whom and how often – including the data it rests on, from which you can remove individual charts.

What do the individual statistics values indicate?

+

Each criterion has its own degree of fulfillment, e.g.:

  • Preferred partners: Share of fulfilled wishes (direct partner or at table)
  • Distance wishes: Share of respected distance wishes (not at the same table)
  • Repetition: Share of new pairs (no repetition from previous plans)
  • Restless Behavior/Concentration: Share of affected students who are separated from each other
  • Genders: Share of tables with balanced distribution

Backups & Persistence

How data is stored locally, how backups work and how to move to a new device.

Where is my data stored?

+

All data is stored in the browser (IndexedDB for core data, localStorage for settings). There is no cloud, no account, and no server synchronization. Your data stays on your device and is not accessible from outside.

Can my data simply disappear?

+

Yes, and that is the price of nothing ever leaving your device. Everything sits in your browser's storage, and browsers clear that out under certain conditions:

  • Safari, for example, deletes the data of sites you have not visited for seven days.
  • “Clear browsing data”, “remove website data” or resetting the browser wipe it too.
  • In a private or incognito window it is gone as soon as you close the window.

Klassenplan asks the browser for persistent storage the first time you create a class, which lowers the risk considerably — but no browser guarantees it. A backup is the only copy that does not depend on any of this. It is safest kept off the machine, on a USB stick or in your school's cloud storage.

How does the backup work?

+

The export creates a file encrypted with your password (at least 8 characters) containing all classes, students including their photos, seating plans, shuffle and usage history, seating circle, classroom features, templates and settings. Without that password the file cannot be restored – so keep it safe to avoid losing your data.

How do I move my classes to a new computer?

+

Through the backup file — there is no sync between devices, because there is no server.

  1. On the old device, click the gear icon in the footer, choose “Export backup” and set a password.
  2. Get the file onto the new device, for example via USB stick, a cloud folder or an email to yourself.
  3. On the new device, open Klassenplan, click the gear icon in the footer and choose “Import backup”.
  4. Pick the file, enter the password and confirm “Replace everything”.

Your classes, students including photos, seating plans and templates are then on the new device. The file works on any operating system and in any browser. Without the password, however, it cannot be opened.

How often should I make a backup?

+

For example after creating a class or after setting up and saving a classroom. Klassenplan reminds you on its own once your last backup is more than 30 days old. You can postpone that reminder or switch it off for good via “Stop reminding me”.

What happens when I import a backup?

+

You choose between "Replace everything" and "Merge". Replacing overwrites existing students, seating plans and templates with the backup – this cannot be undone. Merging adds students and seating plans from the backup to the existing ones; the classroom and settings then come from the backup.

What happens to my backup after a Klassenplan update?

+

Backups are backward compatible and are meant to stay that way – should that ever change, I will provide an extended migration tool. New versions automatically migrate older backups. After major changes, it is worth creating a fresh export so that you have secured the latest structure.

Tips for unwanted results

What you can do if a mix doesn't convince immediately.

How can I improve the result?

+

Use a combination of the following strategies:

  • Increase weights for relevant criteria
  • Mix multiple times to use different random starts
  • Adjust individual seats manually via drag & drop and lock them if necessary so that the algorithm no longer changes them.
  • Take back a poor shuffle with Ctrl/Cmd+Z or load an earlier result from the shuffle history
  • w

Operation & User Interface

Presentation mode, name game, export formats, dark mode, shortcuts and touch.

I want to print the seating plan and have the blackboard shown at the bottom as orientation. Is that possible?

+

Yes. Switch to portrait view in the export area and enable "Show blackboard". If your desk is at the back of the room, for example, also set the viewing direction to "From the back": the display rotates by 180° and the names stay readable. That way the printout keeps the same orientation as the classroom.

Is there a Dark Mode?

+

Yes. You can switch between light and dark color schemes at any time via the switch in the footer. Your selection is stored locally in the browser and loaded automatically on your next visit.

Which keyboard shortcuts does the editor support?

+

In the classroom editor, Ctrl/Cmd + C, Ctrl/Cmd + V, and Ctrl/Cmd + X are available for copying, pasting, and cutting tables. You can find a complete overview of available shortcuts in the help area at the top right.

Is there an introduction to using Klassenplan?

+

Yes. On your first visit, a short tour shows you the most important places in every step – from the class switcher and the backup behind the gear icon in the footer to the statistics and the seating circle. The tour never blocks anything: you can keep working, close it with Escape or switch it off for good with “Don’t show again”. The question mark at the top right starts the tour of the current step again at any time.

How does the Seating Circle mode work?

+

Switch to the "Seating Circle" area via the toggle in Step 3. Klassenplan automatically calculates a suitable circle and links it to your current seating plan. You can adjust the seats in the seating circle manually via drag & drop without changing the seating plan and then export them separately.

How does presentation mode work?

+

Presentation mode shows the seating plan or circle large on a projector or smartboard. You can switch between teacher and student view – the latter turns the plan around to the class's perspective and hides markers and photos. The bar at the bottom toggles markers, photos, colors, the name format and room elements, and lets you zoom and pan. "Who's next?" (or the space bar) draws a random student, and everyone gets a turn before anyone repeats. Press F for fullscreen.

What is the name game?

+

The name game helps you learn the names of a new class. It only uses students with a photo and offers a photo quiz (match the name to the photo or the other way round, with shaky names coming up more often) and a memory game of photo and name cards. Your progress stays local on your device. Start it in step 1 via the "Name game" button.

Which formats can I export the seating plan in?

+

Besides PDF and direct printing you can save the current view as a PNG image or an SVG vector graphic – handy for parent letters, substitute folders or the school portal. Seating plan and circle are exported separately, each in portrait or landscape format.

The names are too long on the plan – what can I do?

+

In step 3, in presentation mode and in the export you decide how names should appear: first name only, first name + last name initial, or first and last name. If a first name occurs more than once in the class, a hint points that out so you can switch to the unambiguous variant.

Can I use Klassenplan on a tablet or whiteboard?

+

Yes. The interface is touch-optimized, including long-press for context menus. Everything works smoothly on tablets and whiteboards. Using it on a smartphone is not recommended and is currently not supported.

Can I install Klassenplan like an app?

+

Yes! Klassenplan is a Progressive Web App (PWA) and can be installed directly on your device. In Chrome, Edge, or Safari, look for "Add to Home Screen" or "Install App" in the browser menu. After that, Klassenplan launches like a standalone app from the dock or start menu – faster, with its own icon, and without the browser bar.

Project & Support

Information on costs, updates, and how you can contribute.

Does Klassenplan cost anything?

+

No, Klassenplan is a free tool that I work on in my free time. I originally developed Klassenplan for my own needs (with the help of Claude Code) and I am happy if it helps you and you like using it. If you like Klassenplan and would like to support its hosting costs as well as further development, I would be happy about a donation via PayPal. You can find all info under "Support". Thank you!

How do I get updates?

+

New versions are loaded automatically as soon as you reload the page. You can find the most important changes in the Changelog.

How can I give feedback or participate?

+

You can send a message at any time via the feedback page. I look forward to practical experiences, bug reports, and feature ideas.

Klassenplan is open source: you can view the source code, report bugs, or contribute your own changes. View the project on GitHub

Under which license is Klassenplan released?

+

The source code is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-or-later). You are free to use, modify, and redistribute Klassenplan – including your own customized versions – as long as you release them under the same terms and disclose the source code. If you run a modified version on a server, its users must be able to access the corresponding source code.

You can find the full source code on GitHub.

This website stores necessary information locally in your browser. No cookies are used and no data is transmitted to servers. More information in our Privacy Policy.