Levels

Levels represent floors of your building. Each level has a background image (floor plan) and contains areas and markers.

Creating a Level

1. Open the Levels panel in the editor
2. Click Add Level
3. Enter a name (e.g., "Floor 1", "Basement", "Parking")
4. Upload a floor plan image

Floor Plan Image

• Supported formats: PNG, JPG, SVG, WebP, GIF
• Recommended resolution: 2000–4000px on the longest side
• Use consistent dimensions across levels for proper alignment

Level Order

Drag levels in the panel to reorder them. The order determines:

• How floors appear in the level switcher
• The default sequence when navigating between floors

Level Key (Slug)

Each level has an optional key — a human-readable identifier (e.g., floor-1, parking). Use keys in the SDK instead of UUIDs:

map.selectLevel('floor-1') // by key
map.selectLevel('Floor 1') // by name — also works

Hiding Levels

Hidden levels are not shown in the public map but remain accessible via the API. Use this for levels under construction or staff-only floors.

Default Level

Set the default level in Project Settings. This is the floor shown when the map first loads.