How to Use Mac WiFi Diagnostics to Troubleshoot Connections
macOS includes a built-in Wireless Diagnostics tool that can capture WiFi logs, scan for interference, and identify specific problems with your connection. It is more powerful than most people realize and often pinpoints the root cause of issues in under a minute.
How to Open Wireless Diagnostics
- Hold down the Option key on your keyboard.
- Click the WiFi icon in the menu bar (top right of screen).
- Select Open Wireless Diagnostics from the menu.
- Alternatively: Spotlight Search (Cmd+Space) → type "Wireless Diagnostics" → press Return.
What Each Mode Does
| Mode | What It Does | Best For |
|---|---|---|
| Assistant (default) | Guided diagnostic - walks you through steps and shows recommendations | First-time users, general issues |
| Info | Shows current WiFi details - channel, band, signal strength, noise, PHY mode | Checking signal quality |
| Logs | Starts continuous logging of WiFi events to a file | Capturing intermittent drops |
| Scan | Lists all nearby networks with their channel, signal, and security type | Finding channel congestion |
| Performance | Real-time graphs of signal quality, transmit rate, and noise floor | Testing different locations in your home |
| Sniffer | Captures raw WiFi packets to a file (requires Wireshark to analyze) | Advanced debugging |
How to Use the Scan Mode to Find Channel Congestion
- Open Wireless Diagnostics → Window menu → Scan.
- Click Scan Now.
- Look at the Channel column. If many networks near you share the same channel, that is causing congestion.
- Note which 2.4GHz channels are least used (1, 6, and 11 are the only non-overlapping options).
- Log into your router admin panel and manually set your router's 2.4GHz channel to the least congested one.
How to Capture Logs for Intermittent Drops
- Open Wireless Diagnostics → Window menu → Logs.
- Click Start Logging.
- Leave it running while you use your Mac normally and wait for the next drop.
- When it drops, click Stop Logging. The log file is saved to your Desktop.
- Open the log and look for "disassociated" or "deauthenticated" events - these show exactly why the connection dropped.
ⓘ After identifying your WiFi issue, use the speed test to verify the fix actually improved your connection speed.