Help
Frequently Asked Questions
Here you can find answers about the algorithm, settings, usage, and the project.
General Questions
Overview of algorithm, privacy, and offline usage.
What does the mixing algorithm actually do?
The algorithm distributes your class across all available seats based on weighted criteria. It first places the students one by one on the best seat left and then improves the arrangement through many swaps – three times from different starting points, and the best plan counts. It takes the selected criteria into account, such as preferred and distance partners, special needs, body heights, window/door preferences and more. With every criterion off, it distributes the class purely at random.
How does the algorithm evaluate neighbors?
The algorithm reads who sits next to whom in five steps, always as seen from the board:
- the seat partner at the same double desk or seat pair (full weight)
- round the corner or across at the same group table (strong weight)
- the seat directly beside at the next table, with no aisle in between (medium weight)
- the other seats at the same group table, such as diagonally across (slightly lower weight)
- the seat directly in front or behind in the next row (lowest weight)
Seats offset diagonally at another table and seats across an aisle do not count as neighbors. Tables pushed together count like a group table: round the corner (such as two desks forming an L) or across counts strongly, and the gender mix, roles and tutoring apply to the whole island. In a row of desks pushed together side by side, the two seats at each join are neighbors like seat partners. The same steps apply when mixing and in the fulfilment the inspector shows you.
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 rates every plan with one score from all criteria. 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. Klassenplan therefore finds a very good solution in a short time, which you can refine further by drag and drop. What cannot be met at all in your class and room, the inspector names under “Notes”.
Class list & class management
Multiple classes, CSV import, photos, the “Attributes” view and the name game.
Can I manage several classes?
Yes. The class switcher at the top left of the header lets you create as many classes as you like, rename them, switch between them or delete them. Each class keeps its own students, classroom layouts, seating plans and recent mixes. Deleting a class also deletes its seating plans.
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 and skips a title line above the headers. The only requirement is a name column – "Name", "First name" or "Last name"; every other possible column such as gender, restless, window seat or preferred partner is optional, and unknown columns are simply ignored. Click "What the CSV file must look 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. Click a student in the class list; in the inspector on the right you add a photo through their portrait. The images are downscaled and stored exclusively on this device – they are never transferred. Using student photos requires consent from the 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 make the name game possible for learning your students’ names.
How do I set an attribute for the whole class quickly?
With “Attributes”, under “View” in the toolbar. The view asks everyone one question – “Who is currently restless?”, for instance – and you tap the students it currently applies to. Then it moves on to the next attribute until every yes/no attribute of the class is set.
How do I edit several students at once?
Tick several students in the list: the inspector on the right then sets gender, height, language level, social role or individual attributes for all of them at once. Search, filters and sorting above the list help you find the right students quickly.
Why does Klassenplan ask whether the markers still hold?
Markers describe how a student behaves right now – and children change. Every marker remembers when it last changed – except left-handed and height, which do not change. Once a class’s markers have stayed the same for twelve weeks, the seating plan asks once: you can go to the class list, confirm with "Still right" – for every class at once with "Still right for all classes" – or put the question off for a week. Nothing changes by itself. The class’s inspector shows when you last confirmed the markers.
Can I try Klassenplan without real student data?
Yes. As long as no class exists, load it from the empty class page with “Load sample class”; later you find the entry in the toolbar under “Import class list”. Klassenplan then creates a class of its own with 24 invented students, drawn portraits and a furnished classroom; your other classes stay untouched. If the sample class already exists, the same entry takes you to it. You can delete it at any time from the class switcher.
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 (find the name for a photo or the other way round; uncertain names come up more often) and a memory game of photo and name cards. Your progress stays locally on your device. You start it from “Class tools” in the toolbar.
Student Properties & Criteria
Overview of all properties and how the algorithm uses them.
On the class layer you record properties for every student – in the inspector, or faster in the “Attributes” view. When you mix the seating plan, they come into play through the criteria selected there. This overview shows every property, what it means and what the algorithm does with it.
Person
- Gender
Male, female or diverse – optional information.
When mixing: Makes for mixed tables: no gender holds more than half of a table. Diverse counts as a gender of its own.
- Height
Small, Medium, or Tall – affects seating row.
When mixing: Places smaller students at the front and taller ones at the back.
Learning
- High Performer
Currently showing particular strengths in class.
When mixing: Enables heterogeneous (peer tutoring) or homogeneous grouping.
- Needs Support
Currently showing additional support needs in class.
When mixing: Enables targeted pairing with high-performing students.
Language
- Language Skills
From native speaker to ESL support.
When mixing: Seats strong speakers next to beginners and language learners for mutual support.
Behaviour
- Restless
Currently showing restless behavior in class.
When mixing: Separates students with restless behavior from each other, across the edge of a table as well.
- Easily Distracted
Currently showing concentration difficulties in class.
When mixing: Keeps students with concentration difficulties away from each other and from students with restless behavior.
Seat & room
- Front seat
This student needs a front seat.
When mixing: At “Very important” the student is sure to sit in the front row; at the levels below, in the front row or the row behind it.
- Window Seat
Prefers a seat by the window.
When mixing: Places the student closer to the window when possible.
- Near Door
Prefers a seat near the door.
When mixing: Places the student closer to the door when possible.
- Free seat beside
This student needs the seat right beside them free – Klassenplan does not ask why.
When mixing: Leaves the seat beside the student empty, at the same table and at the next one with no aisle between. That works as long as the room has more seats than students.
- Left-handed
This student writes with the left hand.
When mixing: Seats nobody who writes with the right hand to the student’s left: they sit at the left end of a table, beside an empty seat or beside another left-hander.
Preferred & Distant Partners
How preferred partners, distance wishes, and special needs influence the calculation.
Where can I see all the wishes of the class at a glance?
On the class layer under “View › Relationships”. It shows who would like to sit next to whom and who wants some distance, and marks the pairs who chose each other. Clicking a name opens that student in the inspector.
How do multiple preferred and distant partners work?
You can choose up to 3 preferred and distance partners per student. The order sets the priority – the first partner chosen weighs more than the third. The algorithm tries to meet as many wishes as possible, with priority 1 taking precedence. Since everybody has only one seat partner, the fulfilment counts each student by the wish met best.
Are preferred partners always considered?
With the “Preferred Partners” criterion at “Consider” or higher, the algorithm seats pairs together unless other criteria speak more strongly against it. If the wished classmate has a distance request for the one wishing, the distance request comes first. A seat at the same group table or directly at the next table counts as partly met. Over several plans, wishes take turns while “Repetition” is on: whoever last sat beside their preferred partner is more likely to sit with another of their wishes next time. Students who wish each other mostly stay together.
How does the system handle restless behavior, concentration difficulties, and distance wishes?
Restlessness, distractibility and distance requests have criteria of their own. The students concerned sit neither at the same table nor directly beside, in front of or behind each other, as far as the room allows – an aisle in between separates them.
How does Klassenplan consider body heights and room preferences?
Body heights feed into the choice of seat so that smaller students sit as far forward as possible. Window and door preferences are stored per student and weighed against the windows and doors you placed in the room. In the fulfilment, the seats nearest the window or the door count as fully met. A student who needs the seat beside them free gets an empty seat there, as long as the room has more seats than students. Left-handers sit with nobody writing right-handed to their left.
Classroom & tables
Tables and room elements, templates, distances and limits.
Which layouts work best?
Let your creativity run free: you drag tables, windows, doors, the teacher’s desk, the blackboard and cabinets from the toolbar into the room – on a phone or a tablet from “Add” at the status bar – or put them on a free spot with a click, and move them anywhere. While nothing is selected, “Set up from scratch” in the inspector builds a floor plan in one go, and under “Templates” you save it for other classes as well. The seating circle stays in sync with the table layout by default, but can also be adjusted separately.
How are distances measured?
Seat positions are stored as pixel coordinates, and Klassenplan reads neighborhoods as seen from the board. At the next table only the nearest seat in each direction counts as a neighbor: beside, while the gap is at most about 45 cm (40 pixels) – more is an aisle – and in front or behind, while the next row is at most about 75 cm (70 pixels) away. Seats offset diagonally do not count. Tables at most about 11 cm (10 pixels) apart count as pushed together.
Are there limits on students and seats?
Yes. Klassenplan is designed for a maximum of 36 students. In the room, the status bar shows whether there are seats for everyone.
Can a class have several seating plans – say, one for the science lab?
Yes. A class can have several rooms, and every room keeps its own tables and plans. For the lab, add a new room with “New room” under “Room” in the room layer, or open a saved room under “Templates” – it then becomes a room of the class. Set up the tables there, mix, and save the plan. With “Open a room …” you switch between the rooms; each opens as you left it, with its seating and locked seats. A saved plan opens its room along with it.
How do I pass a room or a preset on to colleagues?
Save a room as a template first. In the library, choose the room template or preset and tap “Save as file” in the inspector. The file ends in .klassenplan and holds no student data, so it is not encrypted – you can send it by email or through the school cloud. Whoever receives it opens it in the library with “Room template from file …” or “Preset from file …”, a room template also on the room layer with “Open a room from file …”, or like a backup; Klassenplan shows what it holds and adds it beside what is already there. If something there has the same name, the new one gets a number, such as “Room 204 (2)”.
Criteria & fulfilment
How you set the criteria and read how well a plan meets them.
What are presets?
A preset sets all criteria at once to suit the lesson. You find the presets above the criteria:
- Default: Every criterion this class has data for, at its basic setting.
- Quiet work: Separates disturbing factors: restlessness, distractibility, conflicts.
- Group work: Wish partners, peer support and language mixing at one table.
- Written test: As much distance as possible: wishes do not count.
- Getting to know each other: Mix a lot, leave nobody sitting alone, spread the roles around the room.
If you then change a criterion, “changed” follows the name: you can save the change to the preset or keep it as a preset of your own. Your own presets apply to every class and are listed in the Library too; “Restore original” takes an adjusted built-in preset back. “Default” takes you back to the basic settings at any time.
What do Off, Consider, Important and Very important mean?
You set every criterion to one of four levels in the inspector to the right of the seating plan:
- Off: Plays no part in the mix.
- Consider: Taken into account where it fits.
- Important: Counts clearly, but yields to what matters more.
- Very important: Takes precedence over the other criteria.
Criteria your class has no data for stay hidden. For “Front seats”, “Very important” is a fixed rule: the students are then sure to sit in the front row. At the levels below, the row behind it counts as the front too – a student sits further back only when a criterion weighed more asks for it.
How do I recognize that a mix meets the criteria?
On the seating plan, the status bar shows the fulfilment of the plan at its bottom left. A click on it adds a bar with a percentage under every criterion in the inspector.
What do the fulfilment colours mean?
The bars take their colour from how far a criterion is met:
- Green – Fulfillment above 80% (good)
- Orange – Fulfillment between 50% and 80% (partial)
- Red – Fulfillment below 50% (low)
How do I find the seats a criterion affects?
Move the mouse over a criterion’s bar: the seats it affects are marked in the seating plan. A click keeps the marking, a second click removes it. That way you quickly see where swapping seats by hand could improve the result.
How are percentages for preferred partners calculated?
Every student with wishes counts once, by the wish met best:
- Seat partner = 100% fulfilled
- At the same group table (4/6), round the corner or across = 80%, at another seat there = 40% fulfilled
- Directly beside at the next table = 50%, directly in front or behind = 30% fulfilled
- Further away = 0% fulfilled
At single desks there is no seat partner: there, “directly beside” is the best the room allows and counts as 100%. Example at double desks: of 3 students with wishes, one sits beside their preferred partner (100%), one has them directly behind (30%), one has them nowhere near (0%) = (100 + 30 + 0) / 3 ≈ 43%.
What do the individual statistics values indicate?
Each criterion has its own degree of fulfilment, measured against what the class and the room allow – 100% means it cannot get better on that point. For example:
- Preferred partners: Share of students whose wish is met (see above)
- Distance wishes: Share of distance requests kept (not at the same table and not directly beside, in front or behind)
- Repetition: Share of new table pairs (no repetition from earlier plans; students who wish each other do not count as repetition)
- Restless Behavior/Concentration: Share of the students concerned without a neighbor concerned as well
- Genders: Share of mixed tables, measured against the tables the class's make-up allows to be mixed
What do the notes in the inspector mean?
Under “Notes” the inspector names what cannot be met at all in your class and room: more students needing a front seat (“Very important”) than the front row has seats, a group with distance requests among each other larger than the number of tables, a wish answered with a distance request, or a student wished for by more classmates than can sit around them. Then it is not the mix: moving a desk or changing a wish helps.
How does repeat avoidance work?
Repeat avoidance only counts seating charts that were really in use. Pairs from older plans count less with age; who sat together more often counts more. Mere mixes do not count: mixing several times in a row is just trying things out, and chance and the other criteria see to it that the next mix turns out differently. A one-sided wish counts like any other pair, so that wishes take turns and nobody sits beside the classmate who wished for them week after week; a mutual wish counts only half.
Klassenplan keeps track of which seating charts were really in use. If you use automatic detection, Klassenplan watches for the following actions:
- 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 – as always, entirely on your own device.
The plan you are looking at does not count against itself: even after you presented, exported or saved it, “Repetition” compares it only with the other plans in use.
In the “Library” at the foot of the toolbar, a class’s “Neighbourhoods” folder shows for every student whom they have sat next to and how often – including the data it rests on, from which you can remove individual plans. “Reset” forgets every neighbourhood so far at once, say for a new school year.
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:
- Set the criteria that matter to “Important” or “Very important” – or pick a preset that fits the class
- Mix again: every mix already tries several random starts, but a new mix still brings a different plan
- Adjust individual seats manually via drag & drop and lock them if necessary so that the algorithm no longer changes them.
- Take back a poor mix with “Undo” (Ctrl/⌘+Z) or open an earlier result under “Recent mixes” in the “Library”
Presenting, exporting & tools
Interactive whiteboard, seating circle, printing and classroom tools.
How does presentation mode work?
“Present” at the right of the status bar – on a phone in the toolbar – shows the seating plan or circle large on the interactive whiteboard. Every control sits in one bar below the plan: teacher or student view (which turns the plan to the class’s point of view), plan or circle, photos, colours, room elements, a contrast mode for bright rooms and the size. In fullscreen (key F) the bar disappears and comes back as soon as the pointer nears the bottom edge or you tap there. If someone is missing, tap their seat: it fades, and "Who’s next?", "Build groups" and "Hand out duties" leave them out. It lasts for today and is never stored.
What are “Who’s next?”, “Where does who sit?”, “Build groups” and “Hand out duties”?
The classroom tools also work well on a tablet or phone. “Who’s next?” draws a random student, and everyone gets a turn before anyone comes up twice. “Where does who sit?” finds a student in the room. “Build groups” draws groups from the class and keeps distance wishes apart where it can. “Hand out duties” helps you hand out the class duties fairly. You find them under “Class tools” in the toolbar.
How does the seating circle mode work?
On the seating plan, choose “Circle” under “View” in the toolbar. Klassenplan creates a suitable circle automatically, linked to your current seating plan. You can then adjust the seats in the circle by drag & drop without changing the seating plan, and present or export it.
In which formats can I export the seating plan?
The export page saves PDF, PNG and SVG and prints directly – handy for letters to parents, cover folders or the school portal. You choose the seating plan, the circle or the list under “View” in the toolbar, and then adjust how it looks in the inspector.
I want to print the seating plan and have the blackboard shown at the bottom as orientation. Is that possible?
Yes. On the export page, set the orientation to “Portrait” under “Page Format” on the right and leave the blackboard switched on under “Room Elements”. If your desk is at the back of the room, set the viewing direction to “From the back”. That way the printout keeps the same orientation as the classroom.
Can I print a class list?
Yes. “Print list” in the class's toolbar opens it straight away, even before the first mix; on the export page it is “List” under “View”. Every name has room to write beside it: ruled lines for observations, or a grid of empty columns to tick off, whose heads you label yourself with a date or a topic. The order can follow the tables as in the plan or the circle, or be alphabetical.
How do I give a substitute the seating plan?
On the export page, choose “Substitute” under “View” in the toolbar. The sheet shows the seating plan or the circle with the names – without markers and without gender colors, even if you switched them on for your own printout. The header names the class, the room and the day of the lesson, which you set in the inspector. Below the plan you can add a note such as the task and print empty lines for the substitute, for example for who was absent. The note is not stored, and photos only go on the sheet if you switch them on.
Can I print name cards for the desks?
Yes. “Print name cards” on the class layer or “Name cards” on the export page makes a card for every child: tent cards to fold, two per page or one large, or eight badges to wear. The first name stands in a font for beginning readers on writing lines like a first exercise book, beside it a motif – animals, vehicles, nature or food –, the child's photo or a picture of your own, on coloured or white paper. “For colouring in” prints motif and name as outlines. You load a font of your own in the inspector; it stays on the device and goes into the backup.
The names on the plan are too long and too small – what can I do?
On the seating plan under “View settings › Names”, in presentation mode and under “Names” on the export page you decide how names appear: first name only, first name + last initial, or first and last name. Names that would look the same are told apart automatically – “Frida Ehrmann” and “Frida Emmerich” become “Frida Eh.” and “Frida Em.”. Names also grow when there is less on the seats: hide the markers under “View settings › Markers” on the seating plan, with “Markers” in the bar in presentation mode, and under “Markers on the sheet” in the inspector on the export page. Also keep “Enlarge the plan” switched on, and the tables are fitted to the whole sheet.
Operation & interface
Dark mode, shortcuts, undo, the tour, tablets and installation.
Can I undo changes?
Yes, in the class list, in the room, in the seating plan and circle and in the library – so a student deleted by accident comes back with their photo, or a deleted plan comes back, for example. The arrows in the middle of the status bar undo and redo changes, and so do Ctrl/⌘+Z and Ctrl/⌘+Shift+Z. In the library this works until you leave it.
Which keyboard shortcuts are there?
Plenty of familiar ones – Ctrl/⌘+C, V and X copy, paste and cut tables, for example, and Ctrl/⌘+B folds the toolbar in and out. The question mark at the top right lists every shortcut of the current layer under “Shortcuts”; the ? key opens the help directly.
Is there an introduction to using Klassenplan?
Yes. On your first visit, a short tour shows you the most important places on every layer – from the class switcher and the toolbar to the criteria and the seating circle. You can close the tour with Esc or switch it off for good with “Don’t show again”. The question mark at the top right restarts the tour at any time.
Is there a Dark Mode?
Yes. Switch between the light and dark colour scheme with the gear at the top right, in the app and on the information pages alike. Your choice is stored locally in the browser and loaded automatically on your next visit.
Can I use Klassenplan on a tablet or whiteboard?
Yes. On a tablet and an interactive whiteboard everything works by finger: dragging tables, swapping students, and a long press opens the context menu in the room. Klassenplan needs a current browser – Chrome or Edge from version 111, Safari from 16.4, Firefox from 128. If a whiteboard’s built-in browser is older, try Chrome or Edge on the board’s PC. On a phone, the four tools “Who’s next?”, “Where does who sit?”, “Build groups” and “Hand out duties” are meant for the lesson; class and room are better set up on a larger screen.
Can I install Klassenplan like an app?
Yes. Klassenplan is a Progressive Web App and installs straight from the browser: in Chrome and Edge through the icon at the right of the address bar, in Safari on the Mac through “File” → “Add to Dock”, on iPad and iPhone through “Share” → “Add to Home Screen”, in Firefox on Windows through the web app icon in the address bar. “Install as App” in the gear menu shows you the steps for your browser. Afterwards Klassenplan opens in a window of its own from the Start menu or the Dock and works offline. Chrome and Edge can open the app by double-clicking a backup (.klassenplan).
Can our school's IT set Klassenplan up on every computer?
Yes. Edge and Chrome install Klassenplan by policy on every managed computer, without a teacher having to do anything. A school can also host Klassenplan itself – it is a set of static files without a database. Either way, the data stays on each computer.
The guide for administrators is in the project on GitHub.
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.
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. Some features may also be limited there.
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, mix and usage history, seating circle, room elements, templates and settings. Without that password the file cannot be restored.
How do I move my classes to a new device?
Through the backup file — there is no sync between devices, because there is no server.
- On the old device, click “Backup” at the very bottom of the toolbar, choose “Export backup” and set a password.
- Get the file onto the new device, for example via USB stick, a cloud folder or an email to yourself.
- On the new device, open Klassenplan and choose “Import backup” – on the empty class page or, if a class already exists there, under “Backup” at the very bottom of the toolbar.
- Pick the file, enter the password and confirm, for example with “Replace everything”.
On an iPad or iPhone, tapping the file does not open it. Save it to the Files app and pick it in Klassenplan with “Import backup”.
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 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, rooms and seating plans from the backup to the existing ones.
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 an update, it is worth exporting a fresh backup so that you have secured the latest structure.
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” – in the app at the very bottom of every toolbar. Thank you!
How do I get updates?
When a new version is available, Klassenplan asks whether to load it – your data stays as it is. With the gear at the top right you can also look for updates yourself. What has changed is listed 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.
Still unclear?
If your question was not answered here, please write to me via the contact page.