The Settings > Swap Device page (previously called Swap Apps Device) allows you to replace references to one device in all apps with references to another device. The most common use case is replacing a defective device with a newly added device in all apps without needing to manually remove the old selection and re-select the new device in all apps that reference the original device.
¶ Notes and Tips
- It is recommended that the "new" device not be in use by any apps yet (these will not remain associated with the new device; they will be swapped to the "old" device)
- Both devices should have identical or at least similar capabilities, or the new device may not work correctly in apps (e.g., if you replace a dimmer with a switch, apps that try to set level on the device may fail, as plain switches do not support the
Set Level command)
- If one of the devices you are swapping is one you just added to the hub, the same outcome (just with fewer clicks/taps) can be achieved using the "Replace" option that will appear when using the Add Device process with compatible devices
-
"Child devices" (devices with a parent device or parent app) are not eligible for use with this feature and will not be displayed in the list for this reason.
- This is by design, as child devices or their parent may depend on specific characteristics of the other.
- A few specific built-in apps where it is known that no such problems would arise are allowed for this feature (but this should generally be considered an exception and not the norm), including AirPlay, Bluetooth, HomeKit Controller, Tuya, and Wiz integration apps.
-
The list of "new" devices will be filtered to those with at least one overlapping capability with your "old" device after selecting the "old" device. If you do not see your new device in this list (and believe it is otherwise compatible with the tool), verify that it is a similar type of device (e.g., both are motion sensors, switches, or whatever kind of device you are trying to replace).
-
If your device is not compatible, you can still do a "manual" swap:
- Open any apps using the old device (check "In use by" on the device detail page to see which).
- Select the new device in all app preferences where the old device was selected, and de-select the old device. If necessary, configure the new device similarly to the old device (every app is different; many apps will require simply selecting the new device).
- Select Done or any equivalent option in the app to save your changes (unless this particular app notes that this is not required).