UPnP/IGD in Home Assistant
upnp
part of Home Assistant since 0.18
UPnP/IGD is an official Home Assistant integration for Binary sensor, Network and Sensor. Talks to the device on your own network and asks for changes at regular intervals.
Facts about this integration
- Compatible with Home Assistant
- yes, official integration
- Connection
- Local, polling – Talks to the device on your own network and asks for changes at regular intervals.
- Setup
- in the user interface
- Kind
- Single device
- Installations
- 177,337 (25.9 % of the installations that share statistics)
- Categories
- Binary sensor, Network, Sensor
- Provides
- Binary sensor, Sensor
- Found automatically via
- Network discovery (SSDP)
- Maintained by
- @StevenLooman
- Python packages
async-upnp-client==0.48.1, getmac==0.9.5
Setup
- Home Assistant can find this integration on its own: if it is suggested under Settings → Devices & services, confirm it there.
- In Home Assistant open Settings → Devices & services.
- Click "Add integration" and search for UPnP/IGD.
- Follow the dialog – it asks for everything the integration needs.
The link goes through my.home-assistant.io and opens the setup dialog in your own instance – no address of ours is involved.
Known issues and fixes
2 open issues and 0 bug fixes in the last twelve months are recorded for UPnP/IGD in the Home Assistant issue tracker.
Open
- open After upgrading to a newer version, the system can no longer rediscover a D-Link IGD router via SSDP even though it is reachable through HTTP. Affects: D-Link IGD
- open The integration detects a router as supporting UPnP even when UPnP is explicitly disabled on the device.
Source: the issue tracker of Home Assistant, as of September 13, 2026. The sentences are written by a language model from the titles of the issues; the reports themselves are on GitHub.
Check a specific device for known problems in the product check →
Source of this entry: the official documentation of the integration