First steps
Legend
Color Type Description
Empty Not in use yet, not bookable
Assigned Fixed desk, assigned via AD user profile to 1-4 people
Bookable Bookable desk in department
Booked Booked desk in department
Available Hotseat Hotseat, bookable by anyone
Booked Hotseat Hotseat, which has been booked
Desk Booking
  • Make sure you are logged in and click on a hotseat or bookable desk
  • Select the desired date and confirm by clicking on "Book"
  • Your booked seats will appear in yellow color for you, bookings of other people will be in red color
  • Open up your personal menu in the lower left corner to see a list of all your bookings
  • All booked desks for today will have a white dot in the middle
  • To show the whole map for any other date, click on the clock at the bottom and choose a day

  • GDPR notice #1: If you book a desk, your employee information will appear on the map and people will be able to search for it
  • GDPR notice #2: All bookings and the recorded data automatically get removed if you cancel your booking or the booked date is in the past
Advanced Usage

Display meeting room names

Want to highlight all meeting rooms with their names? Just enter "meet" in the searchbox :)

Link to search results

You would like to pass a link to someone with a search?
Use the following syntax:
https://[hostname]/index.php?map=MAPNAME&findme=SEARCHTEXT

Example: https://[hostname]/index.php?map=goeppingen&findme=vogt

Multitarget search link

You would like to pass a link with multiple search terms?
Use the following syntax:
https://[hostname]/index.php?map=MAPNAME&findme=SEARCH1|SEARCH2

Example: https://[hostname]/index.php?map=goeppingen&findme=vogt|hoerz

Teamlinks

Share whole teams easily!
Use the following syntax:
https://[hostname]/index.php?findteam=TEAMNAME

Example: https://[hostname]/index.php?findteam=Chimera
Using the API

Changes API

Get all newcomers and title changes as a beautiful JSON

rest/changes

Optional parameters:
maxresults: limits the output to the last n changes

Desks API

Get all desks with additional information assigned to them

rest/desks

Optional parameters:
map: lists only desks of the specified map
search: list only people and desksnumbers that match the search string

Teams API

Get all teams in Companymaps

rest/teams

Users API

Get a list of all syncronized LDAP users

rest/users

Optional parameters:
search: list only people and desksnumbers that match the search string
title: list only people which titles match the search string
Changelog
Version 92026
2026-07-13Version 9.2
Brand-new admin dashboard

Opening the admin panel now lands on a fresh dashboard that gives you an at-a-glance overview of your installation: the running version and build date, live system health (memory and disk usage) and a status card for every configured integration. Connectivity to LDAP, Microsoft Entra ID, Robin and SAML is checked automatically in the background so you can spot a broken connection before your users do.

Unified directory priority list

All of your user directories are now managed in a single, reorderable priority list – every LDAP and Microsoft Entra ID connection plus Robin, side by side. Drag sources into the order you want and, per source, choose whether it assigns people to desks and whether duplicates are kept. When the same person appears in several directories, the higher-priority source wins, so there's no more juggling of separate, hard-coded rules. Changes take effect instantly at render time, without a resync, and a new seat list lets you preview exactly who ends up where.

Source badge on every desk

The extra Robin-only desk colour is gone. Every occupied directory desk now shares one harmonized look and carries a small badge showing which directory it came from – LDAP, EntraID or Robin – so you can tell at a glance where an occupancy originates, whatever the source.

Identifier migration tool

You can now switch the identifier that ties users to their data from the Windows account name (samAccountName) to their e-mail address – and back – straight from the integration migration assistant. The migration runs as a safe, two-phase “create the new, then remove the old” process that converts avatars, admin records, audit log, bookings and desk references in one go, only flipping the setting once everything is converted, so an interrupted run never leaves things half-migrated.

Other changes
  • New installations now use the e-mail address as the default identifier; existing installs keep their current setting untouched.
  • Microsoft Entra ID connections can now assign people to desks just like LDAP, following the same priority list.
  • Reworked the built-in demo data so it plugs into the new priority engine and works in both identifier modes.
  • Fixed several directory-migration issues and a case where moving a desk could turn it into a manually placed one.
  • Various fixes and polish across the users admin panel.
2026-07-02Version 9.1
Rewritten editing experience

Editing the map has been rebuilt from the ground up. Adding and editing items now happens in a dedicated edit sidebar instead of a pop-up over the map: pick an item from the palette to drop a live draft, position it exactly where you want and confirm to save. Coordinates are two-way – drag an item and its X/Y update, or type X/Y to nudge it into place. A new lasso lets you select several desks at once and auto-align whole pods into neat rows, and the map now opens in edit mode right after you sign in.

Dedicated mobile app

Phones now get a purpose-built, touch-first experience at /m/ with smooth pinch-to-zoom and panning, cross-location search, live meeting-room status and read-only admin views. It can be added to the home screen and launched like a native app.

Microsoft Entra ID integration

CompanyMaps can now sign users in and sync the directory through Microsoft Entra ID, complete with a simple on/off switch in the admin panel.

Avatar cropping tool

Uploading a profile picture now opens an interactive cropper: pick a square area, rotate in 90° steps and apply. It accepts JPG, PNG, GIF and WebP as well as iPhone HEIC/HEIF photos, converting them for you right in the browser.

Other changes
  • Robin sync is more robust: a new Robin-only mode clears duplicate Active Directory desks, a Robin–AD consistency check flags mismatches, and several sync bugs were fixed.
  • The admin sync panel got a consistent look across all its sub-tabs, a separate cache per source and clearer, consolidated check output.
  • Reworked the admin dashboard.
  • Configuration exports now include config.json with the password safely redacted.
  • Fixed the header menus while in edit mode and cleaned up shared-desk warnings.
  • Numerous iOS and Android fixes for the mobile view.
  • Updated the bundled jQuery to 4.0.0 and Chart.js to 4.5.1, and removed the legacy Underscore.js dependency.
2026-06-30Version 9.0
Rewritten in Go

CompanyMaps is now a single self-contained binary. Deployment is as simple as dropping in one file – no PHP, no MySQL and no external sign-on service to set up. There are no more cron jobs to schedule, it runs on every platform (Linux, macOS and Windows) and it is noticeably faster for everyone.

Full Robin integration

Desk bookings now sync straight from Robin: seats people have reserved in Robin show up occupied on the map automatically, with the right person resolved and assigned to each desk – no manual booking needed. This builds on our existing meeting-room integration, which continues to show each room's live availability along with the title and time of the current and next meeting. Everything is configured and kept in sync from the admin panel.

Brand-new search bar with result highlighting

Search across the map you're on and every other location at once, neatly split into “on this map” and “other locations”. Matching desks light up while the rest fade back, and you can combine terms with a pipe, e.g. john|desk5.

Modern overview map

Offices are now placed on a real world map by their address using geolocation (powered by an optional Geoapify integration). Pins for locations that sit close together automatically arrange themselves so they never overlap. Adding an office is as easy as typing its address: a panel slides in from the + button and auto-fills the name, coordinates, country flag and timezone for you, with an “Advanced” toggle for manual overrides and an optional floor-plan upload.

Completely rewritten admin panel

The admin panel has been rebuilt from the ground up: tabs and forms update in place without full-page reloads, the maps, teams and audit-log views got a cleaner look, and there's a new “Geocoding” section to set up the Geoapify key, test it and batch-fill location coordinates.

Other changes
  • Sharper everything: the map, desk labels, clock and menus now render crisply at every zoom level instead of looking blurry when scaled.
  • The changes feed keeps its familiar sidebar and adds a full-screen, searchable view that loads as you scroll; the dead “Join Teams channel” entry has been removed.
  • Refreshed personal menu with a smooth, iPhone-style “Dynamic Island” animation that adapts to the length of your name.
  • Cleaner, consistent login and logout buttons and a refreshed look for this help page.
Deprecated
  • Active Directory (AD) authentication has been removed in favour of the built-in sign-on.
Version 82022–2023
2023-03-20Version 8.1
  • Fixed unsanitized input parameters for GET/POST requests
  • Small bugfix for the overview map in the map list of the admin panel
2022-11-14Version 8.0
  • CompanyMaps is Open Source now! Licensed under the MIT license.
  • Many many cleanups to files and especially the folder structure
  • all remaining hard-coded variables have been moved to the database
Version 72022
2022-11-03Version 7.1
  • Date has been added to the existing clock at the bottom
  • Travel into the future by clicking on the clock and selecting a date. The map and all bookings will be updated accordingly.
  • Added a hover effect to both the personal menu and the clock to make them more intuitive to use
  • Fixed a serious bug for the calendar view on bookable desks. Now it should reflect reality again.
  • By hovering over a booked date in the calendar, the persons name should appear now instead of “someone else”
2022-10-31Version 7.0
  • Desk bookings: easily book your desks and get a unified view and search across all offices. Support for both regular bookable desks and hot desks.
  • New status colors: the number of status colors has been reduced and some colors have changed (e.g. empty desks now appear in grey color). See the legend for more information.
  • SAML login via Azure Apps so you don't have to waste your precious time on typing in your password again and again.
  • Much faster loading times (20x) as core functionalities such as the landing page and the desks API have been fully refactored
  • Sunset of printer API: this was broken for a while and should not be required anymore
  • Cleanup of obsolete code to reduce size and improve readability
  • Search results for teams animation have been significantly reduced in size to be less annoying
Version 62022
2022-09-05Version 6.0
  • User Logins! Finally, all users are now able to login. You won't have admin permissions, but you're able to replace your profile picture
  • Easier login: instead of using your AD username, you can use your full mail address as well
  • Image Upload: just login and click on your profile picture in the lower left corner to replace or delete it
  • Data Deletion: User pictures are only retained as long as the user exists in the Active Directory and will be automatically deleted afterwards
Version 52020–2022
2022-04-26Version 5.3
  • Notifications have updated to use MS Teams instead of Slack
  • Links to channels have been updated
  • The animation on team results has been fixed and is now correctly centered again
2021-04-23Version 5.21
  • fixed some PHP warnings
  • updated chart.js to latest version
2020-10-21Version 5.2
  • Fully revamped admin panel: cleaner look and better assistance for fixing problems
  • Properly declared variables to remove unnecessary PHP warnings
  • Removed obsolete code
2020-10-19Version 5.11
  • User authentication now supports LDAPS, too
2020-10-15Version 5.1
  • LDAP connections now support encryption (=LDAPS)
2020-10-12Version 5.0.1
  • Some desk numbers exceeded the space on the nameplates, so the space has been increased by 50% now.
2020-08-12Version 5.0
  • New Statistics API: For all those (anonymous) funky usage charts. Now with less data collection and much more speed!
  • New LDAP API: sync has been rewritten from scratch, offering more functionality and a consistent user experience for our admins.
  • Some companies grow bigger than expected. To provide more scalability, the LDAP sync is now able to fetch data of up to 26.000 people.
  • Slack notifications now are bundled into a single message per sync, so you don't get spammed any more.
  • If you are curious how many people already used Cmaps today, you can enable a counter in the options.
  • Some visuals were refined to provide a nicer overall look.
  • Fixed some inconsistencies dating back from the changes between v3 and v4.
  • Made some adjustments to support PHP 7.4
Version 42019
2019-12-26Version 4.1
  • Introducing mobile mode (preview): a new UI for smaller devices like smartphones and tablets to assist you on the go.
  • Overlapping labels do not really help. That's why peoples names are now hidden when displaying teams.
  • As more and more locations were added, the map selection sometimes grew out of the screen. It will now split into two columns if it gets too long.
  • In some cases the URL with all its parameters blocked the workflow. In will now be reset to the base URL to keep everything running smoothly.
  • Added customization options for logo and apptitle via database (relevant for admins only)
  • Fixed a bug where names and numbers of shared desks were displayed out of place
2019-12-03Version 4.0
  • Part-time employees and students are important to us - so every desk now supports up to 4 people to make them visible!
  • The database has been redesigned and all items are now properly identified by an extra attribute instead of using some strange algorithm.
  • Search engine has been rewritten in pure JavaScript to fully rely on the APIs introduced in Version 3.x - hyper speed, less network load!
  • Because R&D loves funny team names: Searching for people now also highlights the teams they are part of.
  • Update triggers have been fine-tuned to run less often and save your battery for more important tasks.
  • Leading and trailing whitespaces will be automatically removed from your search now, because nobody should care of invisible typos.
  • The admin dashboard now uses JavaScript to refresh. Finally no more page reloading.
  • Many useless bugs have been kicked out of the house to make your stay more enjoyable.
Version 32019
2019-10-05Version 3.4
  • Changes to database scheme to simplify desktypes for v4
  • Code cleanup for easier readability
  • All update timers (notications, desks, meetings...) reduced to optimize power usage
  • Fixed: Manager border colors don't mess with the color of the desk (blue) anymore
  • Fixed: Hover on mapflag is now always on top
2019-09-18Version 3.3
  • Copy-to-clipboard now uses a fadeout dialog box - saves you one click that can be used somewhere more meaningful ;-)
  • Copy-to-clipboard is now possible for whole maps from the overview, too
  • Dismiss location info now by clicking anywhere on the overview map
  • Fixed: Adding new maps with upper case letters could cause problems on database
  • Fixed: Zoom effect on overview map could cause blurry items on Safari
  • Fixed: On Safari, fonts for smaller items on the overview appeared too large
2019-09-14Version 3.2
  • Overview has been completely redesigned with new map, detail view on locations and scalable icons
  • New feature: Get direct links to people! Click on a desk to stick it and use the copy icon :-)
  • Timezone is now fetched from mapconfig in database
  • Some minor bugfixes
2019-07-22
  • Fixed: Broken links in notifications
2019-07-07Version 3.1
  • Printer status has been added
    • See availability and cadridge status (if available)
    • Stick it to get a link to the configuration page
  • Drag and drop for edit mode (admins only)
    • Click on a desk to edit its properties as before
    • Move a desk to a new position directly
  • Added a map creator for the frontend (admins only)
    • Works like adding a desk on normal maps
    • Preview of map included
    • Deletion only available on the backend, no change here
  • Some minor improvements and bugfixes
    • Overview is now using JS as well
    • Fixed cutoff nameplates when too near to top border
    • Code has been cleaned up
2019-06-28Version 3.0
  • Most of the code has been completely rewritten in JavaScript using REST APIs
  • Redesign of most legacy stuff, like the nameplates
  • Meeting room integration: Status of all Robin-connected rooms is now visible on the map
  • Mobile phone numbers have been added to make it easier to contact people on HomeOffice
  • A clock with the local time of the map has been added at the bottom of the screen
  • Much easier editing of desks (#1 pain point for the admins)
2019-06-16
  • New Desks API in /rest/desks - use the map parameter to filter results. Documentation updated with API section.
Version 22016–2019
2019-06-13
  • New Users API in /rest/users - use the search and/or title parameters to filter results
2019-03-05
  • New Option: Show names. Displays all names directly on the map.
2019-02-28
  • New ChangeNotifier: see who is new on Maps and who got promoted or changed department.
2019-02-15
  • Added filter options to the auditlog (AdminPanel).
2019-02-05
  • Teams can now be linked with their teamnames.
  • Teams have been included in search results.
  • Addressbook has been removed.
2018-12-23
  • Role-based permission controls implemented in frontend and admin panel
2018-12-15
  • Teams sidebar frontend and admin panel implemented
2018-11-16
  • New map selection menu, looks much cleaner now
  • Bugfix to desknumber display option to support names with multiple dashes
2018-10-14
  • Consistency check results are ordered now
2018-07-04
  • Bugfixes to global search and AJAX requests
2018-06-24
  • New infobox implemented - replaces Quickactions
2018-06-12
  • Global search suggestions added to regular maps (by popular demand)
2018-06-09
  • Fixed a display bug for the consistency check.
  • Login and AddItem Dialog are now done via AJAX.
  • Stats in Admin Panel are now shown as soon as they are fetched.
  • Slack Icons removed - did not work as expected.
2018-04-15
  • Config and ShareLibs have been separated for easier updates.
2018-04-04
  • Maps can now also be disabled in addition to be deleted. Admin Panel has been updated to reflect those changes.
2018-03-24
  • HotSeats added
2018-03-13
  • Experimental Slack support added. Click on a desk to open chat window.
  • Addressbook is now an optional setting to save bandwidth.
2018-02-24
  • VIP desks have been moved to a db-based configuration. Admin Panel updated to reflect those changes.
2018-01-14
  • Some tweaks to the print mode. No more printmap required, inverting the map is now done at runtime via CSS.
2018-01-05
  • Full featured admin dashboard has been implemented!
  • LDAP connector updated to dynamically use configuration in database
  • New mapflags in SVG format have been included
  • Bugfixes to global search algorithm
2017-12-23
  • All configuration settings have been moved to database
2017-08-13
  • Minor fixes to scaling algorithm
2017-07-16
  • Manual Scaling reimplemented for more convenience
2017-07-07
  • Perfect AutoScaling implemented! No more manual zooming anymore. Try it out by resizing your browser window :)
2017-06-26
  • Lots of graphical changes to the admin panel to give it a fresher look.
2017-04-07
  • Small fixes to the group display.
2017-04-06
  • Printers now have status links
2017-02-12
  • QuickActions for all occupied desks - click on people to mail or call them
2017-01-25
  • Added a print mode in the options menu (beta!)
2017-01-20
  • Addressbook supports direct dialing via CTI client now
  • Security improvements by switching to session based user authentication
2017-01-13
  • Improved overall search experience - should be faster and more reliable now.
2016-12-30
  • Addressbook added! See a list of all employees, search, mail or call them or do an easy multisearch.
2016-12-21
  • Optimized touch screen navigation. iPad should have a much better experience now!
2016-12-17
  • Your shiny new keycard does not work on a particular door? No problem! All keycard locks in GP are now on the map with their names - and IT will handle the rest for you :)
2016-11-22
  • Added an overlay for the logo
2016-08-27
  • Slight adjustment on info boxes: Mail and phone icons added
2016-08-20
  • First Aid: all kits and rooms of GP/VAI now visible in the map. Try a click on them ;)
2016-08-18
  • Some code cleanup. Everything should look the same as before :)
2016-08-14
  • New item: Service. Displays information of useful services in your building.
  • New item: Exits. Shows where to get out if you need a break from your hard work ;)
  • Modified color of Food item - that sort of yellow looked really strange.
2016-08-13
  • Added new option. The mailto links may now be disabled, so you will get the info box on touch devices, too.
2016-08-06
  • Addressbox on overview map locations added
  • Multitarget search implemented: Demo
  • Fixed some character encoding problems by switching to UTF-8
2016-08-05
  • New map: London added. All location maps available now.
2016-08-04
  • Javascript for settings Menu: opens instantly now
2016-08-01
  • TODA SSL support: Images are loaded via https now, so no mixed content anymore
2016-07-27
  • Instant search: 750% speed increase for all your searches using AJAX! 25% faster than ServiceCamp ;-)
  • Redesign of search results: dark background and centering for better readability
  • New map: Yerevan added
2016-07-23
  • New maps: Adelaide, Munich and Stuttgart-Vaihingen added
  • Multiseating: One person may occupy more than one desk now
  • Itemscaling: Items are able to have a map-specific scale now
  • Blocked desks: Desks may have the status “blocked” now. These desks are neither free nor in use
2016-07-21
  • New setting: all team leaders may be highlighted now using the WoW quality colors
Licenses

CompanyMaps is licensed using the MIT license and uses the following tools in addition:

Name Author and license
Chart.js Chart.js Contributors, MIT license
https://www.chartjs.org
Cropper.js Chen Fengyuan, MIT license
https://fengyuanchen.github.io/cropperjs
heic2any Alex Corvi, MIT license
https://github.com/alexcorvi/heic2any
jQuery JS Foundation, MIT license
https://jquery.com
Roboto Font Google, Apache license 2.0
https://github.com/googlefonts/roboto