Overview
The Facility Map is a drawing of your facility, as seen from above, that shows where each unit is and what its status is. You build and edit the map in Settings, and you can view the same map under Units, where you can filter it, zoom in and out, and download it, but not change it. Facility staff use the Facility Map to add floors, place units and physical features on each floor, and keep the layout in line with the real facility. This article explains what each functionality does and how the functionalities work together.
Key Concepts
The Facility Map uses the following terms – Floor, Object, and Label appear on the screen. Canvas, view mode, and edit mode do not appear on the screen and are used in this article to describe parts and states of the Facility Map.
Floor – One level of the facility. Each floor has its own map, and the floor bar above the map lists the floor names, for example, 1st and 2nd.
Canvas – The white work area where you place units, objects, and labels for the selected floor.
Object – A symbol for a physical feature of the facility that is not a unit, for example, Doors, Gate, or Stairs.
Label – Free text that you place on the canvas, for example, Building B.
View mode – The state in which the Facility Map screen opens. In view mode, you can look at and filter the map, but you cannot change it.
Edit mode – The state that opens after you click Edit Map. In edit mode, you can add, move, rotate, resize, and remove items on the map.
How It Works
The Facility Map screen in Settings works in two modes and keeps changes only when you save them. This section explains the screen layout, the two modes, access, and unit display.
The Facility Map Screen
The Facility Map exists separately for each facility at the Facility level. To open the Facility Map screen, select a facility in the Facility Switcher, click Settings in the sidebar menu, and then click Facility Map. The screen has five areas:
The Unit and Object tabs on the left side of the screen
The toolbar with the Edit Map button, or the Discard and Save changes buttons in edit mode
The filter bar
The floor bar with the Manage Floors link in edit mode
The canvas
Facility Map screen with its five areas numbered
The same map also appears under Units when you click the map (pin) icon on the List of All Units screen. Under Units, you can filter the map, zoom in and out, and download it, but you cannot change it. All changes happen in Settings.
Facility Map view under Units with the map (pin) icon highlighted
View Mode and Edit Mode
The Facility Map screen opens in view mode, where the unit list on the left side of the screen stays grayed out.
Clicking Edit Map switches the screen to edit mode. In edit mode, the Discard and Save changes buttons replace Edit Map, the unit list becomes active, and the toolbar adds the Drag and Drop to add Label icon. The Remove icon appears after you select an item on the canvas.
Edit mode holds every change until you click Save changes. Save changes stores the map, shows the message "Changes saved.", and returns the screen to view mode. Discard drops all changes since the last save and returns the screen to view mode on the first floor.
⚠️ Warning: The Discard button on the Facility Map drops all unsaved changes without a confirmation. You cannot restore a discarded change.
Access to the Facility Map
The Facility Map permission group controls access to the Facility Map. You set the permission group per role at the Corporate level, in Roles & Permissions under Users, on the tab of each facility. The Read permission lets a user view the map, and the Edit permission lets a user change the map.
How the Map Shows Units
The Facility Map draws each unit as a rectangle in proportion to its Width and Length, with the unit number on it. The color of a unit shows its status, and clicking a unit opens a drawer with the unit details and the actions available for the unit status.
The guide to the map under Units [LINK WHEN PUBLISHED: Units: Facility Map View] explains each status color, the indicator dots on units, and the unit drawer.
Using the Feature
This section explains what each Facility Map functionality does and when to use it.
Toolbar
The toolbar above the canvas holds the icons for viewing and editing the map.
Hovering over an icon shows its name. A blue icon means the functionality is on, and a gray icon means it is off.
Save as Default View (eye icon) – Saves the current zoom and position as the starting view of the map, both in Settings and under Units. Use it after you move the map to the part of the floor you check most often.
Download – Downloads the map as a PDF file to print or share. Download Only Current Floor creates [Facility Name] [Floor Name].pdf, and Download All Floors creates [Facility Name] Floors.pdf with one page per floor.
Drag Mode – Lets the mouse move the whole view of the map. Drag Mode does not change the position of any item on the map.
Fullscreen – Hides the sidebar menu and the header so the map fills the screen. Clicking the icon again restores the normal view.
Fit on Screen – Resizes the view so the whole floor fits on the screen.
Show Details (info icon) – Opens the Facility Map Details drawer with the color legend and the mouse and keyboard shortcuts.
Zoom In and Zoom Out – Make the map larger or smaller.
Drag and Drop to add Label (Aa icon) – Adds a label when you drag the icon onto the canvas. Labels name areas of the facility directly on the map. A new label shows the text Example Label. To change the text, select the label, click the pencil (Edit) icon in the toolbar, enter the text in the modal, and click Save. The icon appears only in edit mode.
Remove (delete icon) – Removes the selected unit, object, or label from the canvas. The icon appears in edit mode after you select an item.
Facility Map toolbar in edit mode with the icons numbered 1 to 9
ℹ️ Info: The Save as Default View icon on the Facility Map replaces the saved view right away, without a confirmation. The message "Default view saved." confirms the change.
Filter Bar
The filter bar highlights the units that match the selected values and dims all other units. A filter never changes unit data.
The filter bar shows Unit Group, Class, Dimension, Status, Active, Damaged, Rentable, Delinquent, PTD (Paid Through Date), Area, In Place Rate, Move-In Date, and Category. The window width decides how many of these filters fit in the bar. The X icon at the right end of the filter bar clears all filters.
Facility Map in edit mode with the filter bar highlighted
More Filters opens a drawer with the remaining unit attribute filters. The drawer shows only the attributes that the units of the facility use, so a filter such as Height or Floor appears only when units of the facility have that attribute. For Width, Length, Height, and Floor, the drawer lists the values that the units use, for example, 10 for Width. The drawer can include the following filters:
Width, Length, and Height
Climate Controlled, Floor, Locality, and Door Type
Other unit features: Drive-Up Access, Near Elevator, Covered, Enclosed, Furnished, Alarm, Power, Lighting, Smart Lock, and Monitoring
In the More Filters drawer, the Apply button applies the selected filters.
More Filters drawer on the Facility Map with its three filter sections numbered
ℹ️ Info: The Occupied status filter on the Facility Map also highlights delinquent units, because a delinquent unit is occupied.
Floor Bar and the Manage Floors Drawer
The floor bar above the canvas lists the floors of the facility. Clicking a floor name shows the map of that floor.
In edit mode, the Manage Floors link on the right side of the floor bar opens the Manage Floors drawer.
Facility Map in edit mode with the floor bar, the floor name, and the Manage Floors link highlighted
A facility without floors shows the Add Floor link instead of Manage Floors. You need at least one floor before you can place units when you create the facility map for the first time. The Manage Floors drawer lists each floor with its number of units, for example, 2 Units. In the drawer, you can:
Add a floor to the Facility Map with Add Floor and Save Floor. The floor name is set when you save the floor, and the Manage Floors drawer keeps that name for the floor.
Change the order of the Facility Map floors with the hand icon. The floor at the top of the Manage Floors list appears first in the floor bar.
Remove a Facility Map floor with the X icon. After you click Save Changes in the Manage Floors drawer, the units from the removed floor return to the Unit tab.
Save Changes stores the floor changes, and Cancel closes the Manage Floors drawer without saving them. Cancel drops only the changes made in the Manage Floors drawer, so unsaved changes on the canvas stay until you click Save changes or Discard.
Manage Floors drawer with the Add Floor link and the hand and X icons numbered, and the Save Changes and Cancel buttons highlighted
⚠️ Warning: The X icon in the Manage Floors drawer removes a floor from the list without a confirmation, even when the floor holds units. Click Cancel to keep the floor.
Unit and Object Tabs
In edit mode, the two tabs on the left side of the screen hold the items that you place on the canvas – Unit and Object. Drag an item from a tab onto the canvas to place it on the selected floor.
Unit – Lists the units of the facility with their size and status code. You can place a unit on the map when the unit is active and has Width and Length. The placed unit appears grayed out in the list, so each unit appears on the map only once.
Facility Map in edit mode with the Unit tab and the list of units highlighted
Object – Lists 16 objects: Bin, Camera, Doors, Dump Station, Dumpster, Elevator, EXIT, Fence, Gate, Meeting Room, Office, Parking, Stairs, Toilet, Vending Machine, and Window. You can place the same object more than once, for example, two Doors on one unit.
Facility Map in edit mode with the Object tab and the list of 16 objects highlighted
Changing Items on the Canvas
In edit mode, click a unit, object, or label on the canvas to select it. A blue frame marks the selected item. You move, rotate, and resize the selected item directly on the canvas with the mouse, and you remove it with the Remove icon in the toolbar:
Move – Drag the selected item to a new position on the Facility Map canvas.
Rotate – Hold the left mouse button on the circle above the selected item on the Facility Map and drag. The item turns in 45-degree steps, for example, 0, 45, or 90 degrees.
Resize – You cannot resize a unit, because the size of a unit comes from its Width and Length. To resize an object or label, drag the handles on its sides.
Remove – Click the Remove (delete) icon in the toolbar. A removed unit returns to the Unit tab.
System Messages and Responses
The Facility Map screen in Settings shows the following messages during normal use.
Case 1
Message: "Changes saved."
When it happens: After you click Save changes in edit mode.
What the user should do: Continue working. The map now shows the saved layout in view mode.
Case 2
Message: "Default view saved."
When it happens: After you click the Save as Default View icon.
What the user should do: Continue working. The map opens with this zoom and position next time.
Case 3
Message: "Name is a required field."
When it happens: After you click Save Floor in the Manage Floors drawer without a floor name.
What the user should do: Enter a floor name and click Save Floor again.
Case 4
Message: "Floor already exists"
When it happens: After you click Save Floor with the name of a floor that already exists.
What the user should do: Enter a different floor name and click Save Floor again.
Edge Cases and Conditions
The following situations on the Facility Map can behave differently than expected.
When one item on the canvas partly covers another item, click a visible part of the covered item to select it. The clicked item moves to the top.
When one item on the canvas fully covers another item, drag the top item aside first, then select the covered item.
When Drag Mode is on, Drag Mode stays on while you work on the Facility Map screen, even after you click Save changes or Edit Map again, and dragging moves the whole view instead of one item. Click the Drag Mode icon so the icon turns gray. Drag Mode turns off when you refresh or leave the Facility Map screen.
When Drag Mode moves part of the floor out of view, the items in that part stay on the map, and the full floor appears again the next time the map opens.
FAQ
These are the most commonly asked questions about the Facility Map.
1. Can I change the size of a unit on the Facility Map?
No, the Facility Map does not resize units. The map draws each unit from its Width and Length, so only objects and labels have resize handles.
2. Why does the whole Facility Map move when I try to move one unit?
The whole Facility Map moves when Drag Mode is on, and Drag Mode stays on until you turn it off, refresh the screen, or leave the Facility Map screen. Click the Drag Mode icon so the icon turns gray, then drag the unit again.
3. What happens to units when I remove a floor from the Facility Map?
The units from a removed floor stay in the facility. After you click Save Changes in the Manage Floors drawer, the units return to the Unit tab for placement on another floor.
4. How do I find a vacant unit with specific features on the Facility Map?
Use the filters on the Facility Map. For example, select Vacant in the Status filter, open More Filters, select Both under Climate Controlled, and click Apply. The matching units stay highlighted, and the map dims all other units.
5. Can I print the Facility Map?
Yes, you can download the Facility Map as a PDF file and print it. Click Download, then choose Download Only Current Floor or Download All Floors.
6. How do I undo unsaved changes on the Facility Map?
Click Discard to drop all changes since the last save. Discard does not undo changes that you already saved.







