Sometimes, you may find that something on your hub is not working as expected. Explore one of the troubleshooting guides below based on the details of your particular problem:
Among the most common questions are ones related to problems adding a device to your hub. To resolve this problem, check the following:
- Is your device compatible? Hubitat Elevation includes Z-Wave and Zigbee radios that work with a wide variety of Zigbee and Z-Wave devices, in addition to working with Matter. Check our list of known compatible devices for specific devices known to work, though many more are compatible with built-in generic drivers (or third-party drivers or integration apps). Note that devices running on different protocols, such as the Lutron or Philips Hue Bridge, are added using an integration app, not via the device discovery process on this page.
Note that a device is not compatible simply because it says it is "smart"; the manufacturer must follow standards or provide an open interface for integration that the hub can use. If you have a favorite device that isn't compatible, we suggest providing this feedback to the device manufacturer.
- Check Logs: Monitor the live Logs when attempting to add the device to see if there are any messages that may provide clues about your problem. Entries labeled from "Hub" or "sys:1" and of type "warn" (orange highlight) or "error" (red highlight) are the most likely to be applicable.
- Is your device out of range? Z-wave and Zigbee radios have a limited range that is further reduced by obstructions, including metal, wood, concrete, plaster and drywall. It is important to build out a mesh network that includes plugged-in or AC mains powered devices that act as repeaters and boost the range and signal strength of your hub. Battery operated devices do not function as signal repeaters. If you have Zigbee bulbs, see also the note below.
- Is this a Z-Wave device from another hub? Unless it is a new device (and even then, this is still good troubleshooting), Z-Wave devices must be excluded from their previous network before they can be included on a new network/hub. Ideally, you should perform a device exclusion and a factory reset before attempting to include the device on Hubitat. If the procedure to factory reset is not available, then you should at least perform a general Z-Wave exclusion as described on the Add Device page.
- Are you having problems adding a Matter device? If so, make sure you are using a setup code generated by a Matter Fabric to which the device has already been added (see the steps above). Do not use the original code from the device.
- Is your device in inclusion mode, pairing mode, etc.? All devices are different. Check the device manual to make you have followed the proper procedure to put it in inclusion mode (for Z-Wave devices), pairing or setup mode (a term sometimes used for Zigbee devices), or possibly have reset the device (sometimes the means by which Zigbee devices are put into pairing mode).
- Did your Z-Wave device fail to be included properly? Run a general Z-Wave Exclusion (see the Z-Wave Exclusion section in Add Device for how), then try joining it again.
- Is the device battery dead? Try again with a fresh battery.
- Are there Zigbee bulbs interfering? Certain Zigbee bulbs may interfere with the routing of the Zigbee network traffic (many have problems acting as repeaters for anything other than other bulbs and can cause problems when attempting to repeat for other types of devices; Sengled is one brand with non-repeater light bulbs that are therefore not subject to this concern). If you're having trouble with Zigbee device discovery, try temporarily removing nearby bulbs to see if this alleviates the issue. See the How to Build a Solid Zigbee Mesh and How to Build a Solid Z-Wave Mesh documents for more details.
- If you are having trouble adding a Z-Wave device and none of the above helps, shutdown your hub from Settings > Shut Down, remove the power cable for at least 30 seconds, then re-attach the power cable. Wait a few minutes for your hub to reboot, then try again. See How to Troubleshoot Z-Wave for more troubleshooting if that does not help.
- If you are having trouble adding a Zigbee device or are experiencing problems with already paired Zigbee devices, see the How to Troubleshoot Zigbee.
For the general process of how to add devices to your hub, see: