Install

Requirements

• Home Assistant 2025.1 or newer.
• You set up your plans in the Floorplan Editor in the sidebar. The dashboard card works for everyone in your home.

Before you start

• Devices in areas (rooms): Auto-place and the room filters use them. Areas in Home Assistant
• Areas on floors: each floor plan then offers only its own devices. Floors in Home Assistant

Neither is needed to place devices by hand.

Requirements by feature

Everything works with Home Assistant alone; a few extras need a data source.

Feature	Needs
Auto-place, room filters	Devices assigned to areas
One plan per floor	Areas assigned to floors
Interactive Zigbee map (roles, links, link quality)	ZHA. With Zigbee2MQTT you get each device's signal from its linkquality sensor.
Signal in popups (dBm, %, LQI)	The device's signal sensor enabled
People in their rooms	A room sensor per person (Bermuda, ESPresense, a template…)
Lights stay in their room, night only inside the home, shutters darken a room	Room shapes
Night look following the sun	The Sun integration (otherwise fixed times are used)
Real light colours	Bulbs that report their colour; plain lamps get a colour in the Editor
AC air flow	A climate entity on the device
Bars for doors, windows and shutters	A door / window contact or a cover, and the opening drawn

From the Marketplace (Home Assistant 2026.11 and later)

Since Home Assistant 2026.11, custom integrations come from Settings → Marketplace (it replaced HACS; a Device Floorplan installed with HACS moves over by itself).

1. In the Marketplace, add a custom repository by its link:

   https://github.com/JohnKotrolos/ha-device-floorplan

   The first time, Home Assistant asks you to sign in to GitHub (read-only access to public repositories).

2. Find Device Floorplan, install it and accept the community notice.

3. Restart Home Assistant.

New versions show up as an update in Home Assistant; updating still needs a restart.

With HACS (Home Assistant before 2026.11)

1. In HACS, open the ⋮ menu → Custom repositories, add the link above with type Integration.
2. Find Device Floorplan in HACS and download it.
3. Restart Home Assistant.

Manually

1. Download the latest release from the Releases page and unzip it.
2. Copy the folder custom_components/device_floorplan into your Home Assistant config/custom_components/ folder.
3. Restart Home Assistant.

Updating

Replace the device_floorplan folder with the new one and restart. Your plans, positions and images are kept: they live in .storage/device_floorplan and config/device_floorplan/, not in the integration folder.

Add the integration

Or by hand:

1. Go to Settings → Devices & services → Add integration.
2. Search for Device Floorplan and confirm.
3. Floorplan Editor appears in the sidebar (the setup message and a notification point you there).

The dashboard card is registered automatically: there is no resource to add.

Reinstalling

Plans are kept when you remove the integration. If you add it again, setup lists the plans it found and lets you keep them or start fresh.

Options

Settings → Devices & services → Device Floorplan → Configure:

Option	Default	What it does
Show a notification when new devices are added	On	A Home Assistant notification lists new devices waiting to be placed.
Put new devices on the plan next to their room	On	New devices with an area are placed near their room pin, marked approximate.

Next

Create your first plan →