For a device that will not join a UniFi WiFi network, start with the client's view. Ubiquiti's WiFi Agent shows signal and roaming issues from the client's side, and the Clients panel shows whether the device appears at all. Check the SSID settings: the network name and password, the security mode and whether the SSID is enabled on that AP group.
The checks in more detail
Some devices dislike WPA3 or Fast Roaming (802.11r), and users on U7 releases found that turning off Fast Roaming or using WPA3 only changed behavior, so try one change at a time. Check Minimum RSSI: a threshold set too high disconnects devices with weak signal, so a client that connects and drops immediately may be below it. Check client isolation and network settings: isolation blocks communication between clients even on the same VLAN, so a device that connects but cannot reach a printer is isolated, not disconnected.
Check the VLAN and DHCP: a device with no address or the fallback address needs the network override or switch port tagging fixed. Check the band: 2.4 GHz-only gadgets need a 2.4 GHz SSID. Check airtime: an overloaded AP refuses or stalls clients. Restart the AP if it is misbehaving and update firmware. If the AP itself is not adopted, follow the connectivity article. Try the device on a plain, simple test SSID with WPA2, no fast roaming and no minimum RSSI.
If it connects there, add features back one at a time until it fails, which tells you which setting it dislikes. Keep the test SSID off afterwards. This method is slower than guessing but produces a firm answer, and it avoids leaving a network in a half-configured state. A device that worked yesterday and fails today often had its stored network entry damaged by a settings change, so forgetting the network on the device and rejoining is a quick first step.
Differential
Likely causes of “Ubiquiti UniFi access points will not connect one device”, and how to tell them apart
- 1
Minimum RSSI too high
What separates it The device connects and then drops because Minimum RSSI is set too high
How to confirm Lower the Minimum RSSI setting, so that the device is not disconnected at its usual signal
- 2
Fast Roaming or WPA3 mismatch
What separates it A device cannot join because of a mismatch with Fast Roaming or WPA3
How to confirm Change one setting at a time, and test the device after each change
- 3
Client isolation
What separates it The device cannot reach local devices because client isolation is switched on
How to confirm Adjust the isolation setting, so that the device can talk to the devices it needs
- 4
A wrong VLAN or DHCP
What separates it The device gets no address because of a wrong VLAN or a problem with DHCP
How to confirm Fix the tagging and the DHCP settings for the network that the device joins
- 5
A 2.4 GHz-only device
What separates it The device cannot see the network because it only supports the 2.4 GHz band
How to confirm Provide a 2.4 GHz SSID, so that the device has a network that it can see
Before you touch a setting
Record this first — changing settings destroys the evidence
- The device and its wifi standard
- The SSID settings and security mode
- The signal strength at the device
- Whether the device receives an IP address after it joins
Try in this order
0 of 7 completedCheck the client
ReversibleCheck the client using WiFi Agent, and look at the signal that the device reports.
Check the SSID
ReversibleCheck the SSID, including the name, the password and the type of security in use.
Check Minimum RSSI
ReversibleCheck Minimum RSSI, and make sure that it is not set too high for the device.
Check isolation
ReversibleCheck isolation, in case client isolation stops the device from reaching what it needs, and then test again to see whether it helped.
Check VLAN and DHCP
ReversibleCheck the VLAN and DHCP settings, and confirm that the device receives an address, and then test again to see whether it helped.
Change one setting
ReversibleChange one setting at a time, such as Fast Roaming or WPA3, and test after each change.
Restart the AP
ReversibleRestart the access point and update it, in case an old release causes the problem.
Model-specific
What is true of this model and not of its siblings
- 6 GHz
- The U7 Pro has a 6 GHz radio that needs WPA3 and Wi-Fi 6E or 7 clients.
- U6 Pro
- The U6 Pro has no 6 GHz radio.
Stop boundary
When this stops being a self-service repair
- !If the device joins other networks but not this one after settings changes, contact the device maker
- !If several devices fail, check the AP and firmware
- !If the AP is not adopted, use the connectivity guide
Evidence ledger
Sources behind this answer
Signal strength, AirView and channels.
Client-side diagnosis.
Minimum RSSI.
Client isolation.
The company and its products.
Exact questions
Common questions
Why does my device connect then drop?+
Minimum RSSI may be too high, which disconnects a device at its usual signal strength.
Can WPA3 stop a device joining?+
Yes, some older devices cannot join a network that uses WPA3 only.
What is client isolation?+
Client isolation blocks clients on the wifi from talking to each other.
What if there is no address?+
If there is no address, check the VLAN tagging and the DHCP settings.
Does Fast Roaming matter?+
Some devices dislike Fast Roaming, so try switching it off if one will not join.
Which band for smart plugs?+
Smart plugs usually need the 2.4 GHz band, so give them a network on that band.
Can airtime cause it?+
Yes, an overloaded access point can stall clients, so check the airtime as well.
Should I restart the AP?+
Yes, restart the access point if it misbehaves, and update it to the newest release.