Skip to content

Using the Panel ​

The panel has a header with the floor tabs, a controls row with the tools, and a canvas. It is for administrators only.

The panel: header with the floor tabs, the controls row with the tools, and the canvas with its scale bar and zoom controls

The floor tabs and the Property tab are in the middle. On the right are the Connectivity Map button, Settings and the ⋮ menu.

⋮ Menu ItemAction
Getting Started GuideOpens Your First Floor Plan in a new tab.
Export JSONDownloads the layout as map data.
Download Debug ReportDownloads versions, settings, layout counts and the recent debug log.
Reset FloorClears every room, wall, opening, placed device and the background image of the open floor. Asks first.

Controls Row ​

PartContents
LeftThe tools.
MiddleHints and options for the active tool, such as the Snap menu.
RightBackground, undo, redo and save.

Tools ​

ToolAction
SelectSelects a room, wall, door, window or device. Handles reshape it. A device is dragged to move it. Dragging inside a selected room moves the room with its devices.
PanMoves the view only. A trackpad's two-finger scroll also pans in every mode. A mouse wheel zooms, and so does Ctrl+scroll.
Trace RoomClick each corner, then click near the start to close the outline.
Trace WallClick along the wall. Finish Wall or Enter ends an open run. Clicking the start closes a loop.
Add Door, Add WindowClick a point on a traced wall.
Set ScaleClick two points a known distance apart and enter the distance. Can be repeated at any time.
Place DeviceOpens the device picker. See Placing Devices.
Align FloorsOverlays another floor to line the two up, then applies the transform.

Tracing a wall: the hint, the Snap menu, and the Finish wall and Cancel buttons in the controls row, and a guide line where the next point lines up

New points snap to nearby walls and room edges and line up with the previous point. The Snap menu sets the target: all, walls only, rooms only, or off. Shift places one point without snapping.

WARNING

Applying an alignment rewrites every room, wall, opening and device position on the aligned floor, and cannot be undone. The panel asks before applying.

Info Cards ​

Selecting an item on the plan opens an info card on the left.

SelectionSettings
RoomHome Assistant area (including areas on no floor), name (Use area name resets it to the area's current name), corners, label position, visibility, colour, Fill Opacity and Border Opacity.
DeviceLabel, icon (any Material Design icon), mounting height, and its network links while a layer is on.
WallMaterial, thickness and corners.
Door or WindowWidth.
Connectivity LinkBoth ends and the signal quality. A link to another floor can jump to that floor.
Devices on One SpotChoose which device to select, or remove one from the spot.

A room's info card: its area and name, then its colour and opacity

Phones ​

The info card spans the width and folds down to a header with the chevron at its top right. The controls row scrolls sideways. The device picker opens as a sheet.

The panel on a phone, with the Zigbee layer on

Language ​

The panel follows the language of the Home Assistant user profile. English and German are included. The German translation is machine-drafted and has not been reviewed by a native speaker. Corrections are welcome as an issue or a pull request against frontend/src/translations/de.json. Untranslated strings fall back to English.

Keyboard ​

KeyAction
EscCancels the current trace or armed placement. During a drag, puts the item back.
Ctrl/Cmd+Z, Ctrl/Cmd+Shift+Z (or Ctrl+Y)Undo and redo for the open floor and the Property tab. A drag is one step.
Backspace or Ctrl/Cmd+Z while tracingRemoves the last point.
Delete, BackspaceDeletes the selection, after asking.
EnterFinishes a wall trace.
ShiftPlaces or drags a point without snapping.

Shortcuts do not fire while a field has focus.