Customizing the Occupancy Map

Development Team -

There are a variety of settings that can be used to customize the look and feel of the Occupancy Map.

Accessing the Occupancy Map Settings

To begin customizing, open the Occupancy Map Settings by navigating to the Occupancy Map and clicking/tapping the toolbar button with the gear icon:


We've split the Occupancy Map Settings up into the following sections:

  • Occupancy Colors
    Customize the colors used for reservation status, payment status and other types of occupancy.

  • Unit Colors

    Customize the colors used in the unit header section on the left hand side of the occupancy map based on unit, unit type/rate plan and/or property.
  • Display Settings

    More settings to control cells sizes, weekend days, the clean/dirty feature and the Book by Type feature


Occupancy Colors

The Set Reservation Color setting allows you to configure how reservations are displayed on the Occupancy Map.

  • In-House Status
    • The In-House Status Colors will be used to color unit assignments for reservations based on their current in-house status of each assignment.
    • In this mode, the payment status for the reservation will be displayed using a money icon mceclip2.png in the bottom right hand corner of each reservation assignment. The color of the icon will be determined by the Payment Status Colors.
  • Payment Status
    • The Payment Status Colors will be used to color reservations based on the current payments status of the reservation.
    • In this mode, the in-house status of the reservation will be displayed using either no icon (when the reservation assignment has not yet checked in), the checked-in icon mceclip3.png or the checked-out icon mceclip4.png. The color of the icon will be determined by the In-House Status Colors.

The Other Colors section allows you to control the New Selection color used when creating/selecting reservations and the color for Out of Service blocks.


Unit Colors

The Occupancy Map shows the name of the unit in a header section the runs down the left hand side of the screen. These unit headers can optionally be colored based on the Property or the Unit Type/Rate Plan they belong to, or they can each be colored individually. Or you can use some combination of each of those aspects. 

There are a variety of ways you might think about applying colors to your units on the Occupancy Map. Some common examples include:

  • Quickly identify units or types of units with the same rates.
  • Identify units based on location or their level within a building.
  • Indicate specific amenities or views. 
  • Each unit is unique and deserves it's own color! 

The Color Options allow you to enable any combination of the 3 options:


With all 3 features enabled, the Property Color Bar will appear on the far left edge of the unit header cell, the Rate Plan (Unit Type) Color Bar will be shown next to the Property Color Bar and finally, the rest of the unit cell can be colored by using the Unit Color option. The following graphic shows an example of how this can look with all 3 features enabled.


  • If the Property Color Bar is not enabled, the Rate Plan (Unit Type) Color Bar will move to the far left and if neither of those options are enabled, then no color bars will be displayed.
  • Each option can be enabled or disabled based upon how you like to categorize and display your units. 

In the Units section, the Set Colors From dropdown button makes it simple to apply colors categorically to all of your units if you prefer to see the entire unit header colored based on Property or Rate Plan (Unit Type). 

For example, consider the following configuration for unit colors: 

Considering that all these units belong to only a single Property, with all 3 options enabled, the units would appear as shown below on the Occupancy Map with a Property Color Bar on the far left, the Rate Plan (Unit Type) Color Bar next to that and the Unit Color filling the entire background of the unit header cell.  

Note that the Rate Plan (Unit Type) Color Bar is actually visible here even though you can't see it because the Rate Plan color and the Unit color are the same. Disabling it would hide that color bar and shift the unit names a little be further left which might be valuable depending on the lengths of your unit names.

The Units section also features a dropdown button next to each unit that allows you to apply the color of the Property or the Rate Plan (Unit Type) for only that unit (as shown below): 



Display Settings

Weekend Days - The days chosen here will be shaded on the Occupancy Map display to make mid-week and weekend days more visually obvious.

Show Clean/Dirty - Toggle the Clean/Dirty feature. With the Clean/Dirty toggle enabled, units can be marked as Clean and Dirty from the Occupancy Map. 

Book by Type - Toggle Book by Type mode. With the Book by Type toggle enabled, the Occupancy Map will collapse units into their Rate Plan (Unit Type). For businesses with lots of units or groups of units with identical rates, this can really help simplify the Occupancy Map display by only showing "types" of units by default, rather than all individual units. 

Daily Cell Width & Height - Control the size of the cells on the Occupancy Map.

Please Note! Smaller cell sizes will allow you to see more days and/or units but will limit what you can see within the cell (reservation and guest names, phone numbers, status icons, etc.) due to the size restriction. The Preview area will give you an idea of what text will be visible/cut-off based upon your chosen cell size. 

PERFORMANCE WARNING! Very small cell sizes will likely affect the performance of the Occupancy Map. The smaller the cell size, the more cells that must be rendered on your screen and this can become a demanding operation. Other factors that affect performance as a result of small cell sizes:

  1. Monitor size and resolution. The bigger your monitor and resolution, the more cells that can be displayed on it. This might seem great, but again, the more cells the occupancy map has to render, the more performance might be impacted negatively.
  2. Occupancy. If you have lots of a bookings AND you are displaying a lot of days (due to a small cell width and/or big screen size), then the app must download and render all of those bookings on the Occupancy Map. Again, this might seem great, but might degrade performance.

Feel free to play with the Daily Cell Width & Height to find the right balance between performance and usability for your needs. 

Have more questions? Submit a request


Please sign in to leave a comment.