--- title: "UniFi Network Map" description: "UniFi Network Map is a Marketplace integration for Home Assistant. It has 503 installs sharing analytics, works locally and was last updated October 26, 2026." canonical: "https://vulpo.app/integrations/marketplace/merlijntishauser-unifi-network-maps-ha" url: "https://vulpo.app/integrations/marketplace/merlijntishauser-unifi-network-maps-ha.md" last-updated: "2026-10-22" version: "1.4" --- # UniFi Network Map > UniFi Network Map is a Marketplace integration for Home Assistant. It has 503 installs sharing analytics, works locally and was last updated October 26, 2026. UniFi Network Map is an integration that draws an interactive topology map of a UniFi network. It connects locally to a UniFi controller using either a username and password or a site-level API key, and it is set up in the UI. The map shows how gateways, switches, access points and clients link together, with optional port labels, client filtering by wired or wireless, and a choice between a flat and an isometric layout. Display options include several color themes, two icon sets, and custom map width and height. Besides the map card, it adds sensors and binary sensors for status, clients and device presence. It is meant to run next to the built-in UniFi integration, which lets a device on the map link to its Home Assistant entity. Automatic summary of the README and code of merlijntishauser/unifi-network-maps-ha. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=merlijntishauser&repository=unifi-network-maps-ha&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=merlijntishauser&repository=unifi-network-maps-ha&category=integration) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Connect to UniFi - **Controller URL**: Include the scheme (http or https) and port if needed. - **Username** - **Password** - **API key**: Site-level API key from UniFi OS (Settings -\> Control Plane -\> Integrations). Use this instead of username and password. - **Site**: The internal site ID, usually 'default'. For a multi-site setup use the site code shown in the Network app URL (the segment after /manage/ or /network/), not the site's display name. - **Verify SSL** ### Map Options - **Show port labels**: Adds switch port labels to links. - **Show clients**: Includes client devices on the topology. - **Client scope**: Choose wired, wireless, or all clients. - **Only UniFi devices**: Hide non-UniFi devices in the topology. - **Isometric layout**: Render a 3D-style view. - **SVG width (px)**: Leave blank to auto-size. - **SVG height (px)**: Leave blank to auto-size. - **Request timeout (seconds)**: Abort UniFi API calls after this many seconds. - **Cache rendered map**: Re-use the last render between polls. ### Re-authenticate - **Username** - **Password** - **API key**: Site-level API key from UniFi OS (Settings -\> Control Plane -\> Integrations). Use this instead of username and password. ### Reconfigure connection - **Controller URL**: Include the scheme (http or https) and port if needed. - **Username** - **Password** - **API key**: Site-level API key from UniFi OS (Settings -\> Control Plane -\> Integrations). Use this instead of username and password. - **Site**: The internal site ID, usually 'default'. For a multi-site setup use the site code shown in the Network app URL (the segment after /manage/ or /network/), not the site's display name. - **Verify SSL**: UniFi controllers use self-signed certificates by default, which will fail verification. Only enable if you have installed a trusted certificate. ### After setup - **Update interval (minutes)**: How often to refresh data from the UniFi controller. - **Show port labels**: Adds switch port labels to links. - **Show clients**: Includes client devices on the topology. - **Client scope**: Choose wired, wireless, or all clients. - **Only UniFi devices**: Hide non-UniFi devices in the topology. - **Isometric layout**: Render a 3D-style view. - **Map theme**: Color theme for the rendered map. - **Icon set**: Icon style for device nodes. - **Isometric lighting**: Shades tile side faces and adds contact shadows (isometric layout only). - **Route links around devices**: Routes links around nodes that would otherwise be crossed (isometric layout only). - **Show floor grid**: Draws the isometric floor grid behind the map (isometric layout only). - **SVG width (px)**: Leave blank to auto-size. - **SVG height (px)**: Leave blank to auto-size. - **Request timeout (seconds)**: Abort UniFi API calls after this many seconds. - **Payload cache TTL (seconds)**: Cache enriched payload data for this many seconds. Set to 0 to disable. Texts from the code of [merlijntishauser/unifi-network-maps-ha](https://github.com/merlijntishauser/unifi-network-maps-ha). ## Entities - **Sensors**: Status, Clients ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. ## From the README > A Home Assistant integration that visualizes your UniFi network topology as an interactive map. See how your devices connect, which clients are online, and understand your network structure at a glance. From the README of [merlijntishauser/unifi-network-maps-ha](https://github.com/merlijntishauser/unifi-network-maps-ha#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Computers and network](https://vulpo.app/integrations/category/computers-and-network.md), Routers and network - Brand: [Ubiquiti](https://vulpo.app/integrations/ubiquiti.md) - Number: 503 installs sharing analytics; 38 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v0.5.11, last updated October 26, 2026 - Domain: `unifi_network_map` - Source: - Issues: - Screenshot: https://vulpo.app/integrations-img/34bd4a187f16eb16.webp (from merlijntishauser/unifi-network-maps-ha's README) In Vulpo: Chart card, Apple Watch ## Other ways in for Ubiquiti | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [UniFi Network](https://vulpo.app/integrations/core/unifi.md) | Built-in integration | 42.8k installs sharing analytics | Works locally | Part of Home Assistant | | [UniFi Protect](https://vulpo.app/integrations/core/unifiprotect.md) | Built-in integration | 25.6k installs sharing analytics | Works locally | Part of Home Assistant | | [UniFi Access](https://vulpo.app/integrations/core/unifi-access.md) | Built-in integration | 1.6k installs sharing analytics | Works locally | Part of Home Assistant | | [Unifi Access](https://vulpo.app/integrations/marketplace/imhotep-hass-unifi-access.md) | Marketplace integration | 693 installs sharing analytics | Works locally | Updated in the last 6 months | | [UniFi Hotspot Manager](https://vulpo.app/integrations/marketplace/ufozone-ha-unifi-voucher.md) | Marketplace integration | 413 installs sharing analytics | Works locally | Updated in the last 6 months | Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-22. Source: https://vulpo.app/integrations/marketplace/merlijntishauser-unifi-network-maps-ha --- - HTML version of this page: https://vulpo.app/integrations/marketplace/merlijntishauser-unifi-network-maps-ha - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml