This repository ships the new SmartThings integration for Home Assistant ahead of its release in Home Assistant itself. It replaces the built-in SmartThings integration while installed.
It is temporary. The same code is proposed for Home Assistant in home-assistant/core#191668. When Home Assistant ships it, Home Assistant shows a repair notice asking you to remove this version.
Important
While this version is installed, Home Assistant does not update the built-in SmartThings integration. Report problems in this repository's issues, not to Home Assistant.
Requires Home Assistant 2026.12 or newer (currently the dev branch or a 2026.12 beta). It does not work on 2026.11 or earlier.
- In HACS, open the menu in the top right and select Custom repositories.
- Add
https://github.com/SmartThingsCommunity/ha-smartthingswith the type Integration. - Search HACS for SmartThings, open it and select Download.
- Restart Home Assistant.
Your existing SmartThings devices and settings stay in place.
- Download the latest release from the releases page.
- Copy the
custom_components/smartthingsfolder into thecustom_componentsfolder of your Home Assistant configuration directory, the folder that holdsconfiguration.yaml. Createcustom_componentsif it doesn't exist. - Restart Home Assistant.
- In HACS, open SmartThings, open the menu and select Remove. If you installed manually, delete
custom_components/smartthings. - Restart Home Assistant. The built-in SmartThings integration takes over again.
If you removed this version before Home Assistant includes the new integration, SmartThings entries that you added or reauthenticated with this version will fail to load in the built-in integration. Delete those entries and add SmartThings again, which the built-in integration only allows with Home Assistant Cloud.
custom_components/smartthings is generated. Do not edit it by hand.
It is the core code at the commit in CORE_REF, plus the overlay in overlay/:
manifest.json: addsversion,issue_tracker,documentationandcodeowners, dropsquality_scale, and turns the exactpysmartthingspin into a range, as hassfest requires for custom integrations.retire.py, hooked intoasync_setup_entry: shows the repair notice once Home Assistant contains the merged code.translations/en.json: the text of that repair notice.brand/: the SmartThings icon and logo, which HACS requires in the repository even though core already has them.
To update from core:
# In the core checkout, at the commit you want
python3 -m script.translations develop --integration smartthings
git rev-parse HEAD > ../ha-smartthings/CORE_REF
# In this repository
python3 scripts/sync_from_core.py --core ../coreBump version in overlay/manifest.json for every release. CI fails if the integration doesn't match CORE_REF plus the overlay.
Licensed under the Apache License 2.0. The integration is taken from Home Assistant, with the changes listed under Maintainers.