Quick answers
FAQ
Common questions for hotel operators and developers. Step-by-step guides live in Documentation. Documentation.
Getting started
What is the company or hotel name for?
It is your brand on signup. We derive a URL slug from it (e.g. harborview-hotels) used in every public guest link: /your-brand/your-property. You can edit it later under Settings → Account.
What are the main floorplan tools?
Layout draws the building outline, walls, doors, and pathways. Rooms draws rentable room shapes and links inventory. Amenities draws service zones (stairs, gym, pool, etc.) and assigns types by drag-and-drop.
Why did my new floor copy the outline from below?
Floors share the same footprint. A new floor starts with the previous floor's closed outline so you only adjust what changed on that level.
Drawing and editing
My room shape warps when I drag it
Room moves translate the whole polygon rigidly. Corners snap together but angles stay the same. If you see warping, refresh the page; older builds snapped each corner separately.
Can I edit the building outline on lower floors?
Yes. Changes cascade upward to higher floors that haven't been customized on their own. They never change floors below you.
Do undo steps survive a browser refresh?
Yes. Up to 20 undo steps per floor are stored in localStorage.
Metric or imperial: where does it apply?
Toggle units under Account settings or in the floorplan editor. Wall lengths, dimensions, and guest map distance labels (m vs ft) all follow the same preference. Walk times stay in minutes.
Rooms, amenities & guest map
Why does the map show a different name than my PMS?
The canvas shows the inventory display name you set under Rooms. PMS reference codes stay in the room sidebar for staff only.
Where do I edit room upcharges and categories?
Top navigation → Rooms. Categories show PMS photos when connected. Click a room card to open the sidebar for upcharge, name, description, and photos. Assigned / unassigned reflects whether the room is linked to a shape on a floorplan.
How do I make a room into stairs or an elevator?
Draw the room shape, then in Amenities drag Stairs or Elevator onto that shape. The room becomes that amenity zone.
What is the guest URL for my property?
Public pages use /{company-slug}/{property-slug}, for example /harborview-hotels/harbor-inn. Set the property slug under Settings → Property. Get embed shows the shareable link and install snippets.
Why is my walk route going to stairs instead of the amenity?
Cross-floor amenities need matching circulation (stairs/elevator) on both floors, doors on enclosed zones, and pathways for outdoor areas. Check that the amenity floor name matches the level you expect (including annex names).
What does the walking speed multiplier do?
It scales estimated walk minutes on the guest map. Higher numbers mean faster walking (shorter times). 1.0 is average pace. It does not change real distances.
How do amenity colors on the guest map work?
Under Property settings choose semantic colors (pool blue, garden green), a light brand tint from your property color, or a custom tint. Room colors always use your property color.
Phone & tablet
Can I edit the floorplan on my phone?
Phone-sized screens can use the dashboard, Rooms inventory, Get embed, and basic account/property settings. Floorplan canvas editing and PMS setup need a tablet or desktop.
How do I move a room to another category on mobile?
On the Rooms page, tap a room card and choose Move to different category. Pick the new category from the sheet. On desktop you can also drag cards between category sections.
Account and property
Where do I delete a property?
Settings → Property → Delete property. You must type the property name in the confirmation modal. This is not in the property switcher to prevent accidents.
Can I change my email?
Not in the app yet. Email is read-only under Account settings.
Can two people edit the same account at once?
No. MapStay allows one active signed-in session per account. When you sign in elsewhere, the previous browser or tab is signed out automatically to prevent conflicting edits.
Developers
Where is workspace data stored?
Signed-in users sync to Supabase. The browser also keeps spatial-platform-workspace-v2 in localStorage for fast edits. Floor undo history uses spatial-floor-history-{floorplanId}.
How are amenity zones represented?
StoredAmenity with partition[], closed, and type_enum (null until assigned). See normalizeAmenity() for migration from legacy point amenities.