--- title: "Yeelight Pro" description: "Yeelight Pro is a Marketplace integration for Home Assistant. It has 57 installs sharing analytics, needs the vendor's cloud and was last updated July 1, 2026." canonical: "https://vulpo.app/integrations/marketplace/yeelight-ha-yeelight-pro" url: "https://vulpo.app/integrations/marketplace/yeelight-ha-yeelight-pro.md" last-updated: "2026-10-22" version: "1.4" --- # Yeelight Pro > Yeelight Pro is a Marketplace integration for Home Assistant. It has 57 installs sharing analytics, needs the vendor's cloud and was last updated July 1, 2026. Yeelight Pro is an integration that connects Yeelight Pro homes, devices, gateways and scenes to Home Assistant. It supports Yeelight cloud, private deployment and local gateway connection modes, and it is set up in the UI. It adds lights, climate, covers, fans, sensors, switches, buttons, numbers, selects, events and binary sensors, plus selectors for the active room, group and scene. Options cover the polling interval, WebSocket event notifications, filtering of unknown capabilities, and choosing which rooms, gateways and devices to import. Admin actions assign areas, refresh data, and run a registry cleanup that starts as a dry run, and devices can start automations directly. Repairs notices appear when the device list changes, and a diagnostics file can be downloaded. Automatic summary of the README and code of Yeelight/ha\_yeelight\_pro. 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=Yeelight&repository=ha_yeelight_pro&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=Yeelight&repository=ha_yeelight_pro&category=integration) ## Supports - **Uses the vendor's cloud**: Needs an internet connection and an account with the vendor. - **Device triggers**: Its devices can start automations directly. - **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. ### Select Connection Mode - **Connection Mode** ### Access Token authentication - **Access Token** ### Select authentication method - **Authentication method** ### Select House - **House** ### Select devices - **Devices** ### Private Deployment URL - **Service root URL** - **WebSocket push URL** ### Select cloud region - **Region** ### Reauthentication - **New Access Token** ### After setup - **Polling interval (seconds)** - **Enable debug services** - **Hide unknown capability entities** - **Create Repairs on topology changes** - **Enable WebSocket event notifications** - **Private deployment WebSocket push URL** - **Enable local gateway control** - **Local gateway address** - **Local gateway port** - **Device Categories** - **Rooms** - **Gateways** - **Devices** - **Devices** Texts from the code of [Yeelight/ha\_yeelight\_pro](https://github.com/Yeelight/ha_yeelight_pro). ## Entities - **Selects**: Active room, Active group, Active scene ## Actions - **Assign Areas**: Assign areas to HA devices or devices linked to entities (admin service) - **Auto Assign Areas**: Assign areas based on room keywords in device names (admin service) - **Emit Debug Event**: Emit a debug Yeelight Pro device event to the Home Assistant event bus (admin service) - **Dump Push Health**: Write aggregate Yeelight Pro WebSocket push diagnostics to the Home Assistant log (admin service) - **Emit Debug Push Payload**: Inject one synthetic Yeelight Pro property push to verify the live refresh path; this does not control a real device (admin service) Fields: Node type, Push payload shape, Property parameters, Source device ID, Entity ID - **Manual Refresh**: Refresh loaded Yeelight Pro data and synchronize device and entity registries (admin service) Fields: Refresh product schemas - **Registry cleanup dry-run**: Dry-run stale Yeelight Pro entities; after confirmation, disable stale entities through the Home Assistant registry (admin service) Fields: Config entry ID, Confirm cleanup, Audit ID ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **Repair notices**: Notices it can show in Settings, Repairs: Yeelight Pro device list changed ## From the README > Yeelight Pro is a Home Assistant custom integration for Yeelight Pro homes, devices, gateways, scenes, and runtime diagnostics. It supports Yeelight cloud, private deployment, and LAN gateway connection modes through one config flow. > > - Cloud, private deployment, and LAN gateway setup in one config flow > - Yeelight APP scan-login setup through regional account APIs; QR-code login is the primary cloud login UX > - Advanced manual access-token setup for existing Yeelight Pro deployments > - Reauthentication flow for expired or invalid tokens > - Configurable polling interval, debug mode, unknown capability filtering, manual non-destructive device import filtering, live updates, LAN gateway control, and topology Repairs notifications > - Product schema loading from both v1 and v2 schema endpoints, merged conservatively for maximum capability coverage > - Persistent Home Assistant.storage product schema cache for stable schema-aware projections across restarts > - Canonical -\> adapter -\> converter -\> projector -\> entity architecture > - Lightweight Yeelight IoT registry for category, component, property, event, protocol, and nodeType facts > - Device registry topology for gateways, child devices, scenes, groups, rooms, areas, and house-level helper entities > - House-level analytics diagnostic sensors for alarm, energy, user-action, and endpoint-health aggregates; optional analytics endpoint failures degrade to unavailable diagnostic values instead of… From the README of [Yeelight/ha\_yeelight\_pro](https://github.com/Yeelight/ha_yeelight_pro#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Lighting](https://vulpo.app/integrations/category/lighting.md), Bulbs and lamps - Brand: [Yeelight](https://vulpo.app/integrations/yeelight.md) - Number: 57 installs sharing analytics; 3 GitHub stars - Connection: Needs the vendor's cloud - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v1.0.5, last updated July 1, 2026 - Domain: `yeelight_pro` - Source: - Issues: In Vulpo: Light card, Quick Toggle card, Cover card, Climate card, Apple Watch, Control Center, Climate Live Activity (Pro) [Widgets & Live Activities in Vulpo](https://vulpo.app/features/widgets-and-live-activities) ## Other ways in for Yeelight | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [Yeelight](https://vulpo.app/integrations/core/yeelight.md) | Built-in integration | 12.1k installs sharing analytics | Works locally | Part of Home Assistant | | [Yeelight bluetooth](https://vulpo.app/integrations/marketplace/hcoohb-hass-yeelightbt.md) | Marketplace integration | 111 installs sharing analytics | Works locally | No update in 6 to 18 months | | [Yeelight Sunflower](https://www.home-assistant.io/integrations/yeelightsunflower/) | Built-in integration | 8 installs sharing analytics | Works locally | Part of Home Assistant | | [Yeelight Cube Lite](https://github.com/Max-src/yeelight-cube-lite) | Marketplace integration | 6 installs sharing analytics | Works locally | Updated in the last 6 months | | [Yeelight Themes](https://github.com/Yeelight/ha_yeelight_themes) | Theme | 1 GitHub stars | Connection not stated | 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/yeelight-ha-yeelight-pro --- - HTML version of this page: https://vulpo.app/integrations/marketplace/yeelight-ha-yeelight-pro - 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