Back to the overview

UPnP/IGD in Home Assistant

upnp part of Home Assistant since 0.18

Local, polling Set up in the user interface

The UPnP/IGD integration connects Home Assistant to Universal Plug and Play devices on the local network, enabling monitoring and interaction with devices like media servers and smart home gadgets. It automatically discovers devices via SSDP and provides sensor data for tracking presence and network status.

Typical uses

  • Monitor device presence
  • Track network status
  • Control media playback
  • Manage smart home gadgets

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
183,601 (25.6 % 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.49.0, getmac==0.9.6

Setup

  1. Home Assistant can find this integration on its own: if it is suggested under Settings → Devices & services, confirm it there.
  2. In Home Assistant open Settings → Devices & services.
  3. Click "Add integration" and search for UPnP/IGD.
  4. Follow the dialog – it asks for everything the integration needs.

Add to my Home Assistant

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 1 bug fixes in the last twelve months are recorded for UPnP/IGD in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.10.0.

Open

  • open After upgrading to a newer version, the system can no longer rediscover a D-Link IGD router via HTTP using SSDP. Affects: D-Link IGD since July 1, 2026 · 0 reactions · 13 comments · #175311
  • open The UPnP integration detects a router even when UPnP is explicitly disabled on the device. since May 28, 2026 · 0 reactions · 8 comments · #172480

Fixed

  • fixed in 2026.10.0 The UPnP notify server continued running even after the configuration was removed. Fix #184515 · Issue #184165

Source: the issue tracker of Home Assistant, as of October 25, 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
The description was written by a language model from the facts listed here, not taken from the documentation.

Scroll to Top