macOS Troubleshooting

Reset the Bluetooth module on Mac

Fix flaky AirPods, mice, and keyboards with a Bluetooth reset.

9 min read Beginner Updated 9 Jun 2026

Step-by-step guide

Work through each section in order. Stop when your issue is resolved — you do not need every step for every situation.

Warning

Resetting Bluetooth removes all paired devices — keyboards, mice, AirPods, trackpads. Have USB input devices or wired alternatives ready before reset, especially on desktop Macs.

What you will achieve

Reset the Mac Bluetooth module when accessories fail to pair, drop constantly, or show connected but do not work — clearing corrupt pairing state without reinstalling macOS.

1) Try quick fixes first

  1. Toggle Bluetooth off and on in Control Centre.
  2. System Settings → Bluetooth — Forget the problem device, put it in pairing mode, re-pair.
  3. Charge or replace batteries on wireless accessories — low power mimics module failure.

2) Reset Bluetooth module (hidden menu)

  1. Hold Shift+Option and click the Bluetooth icon in the menu bar.
  2. Choose Debug → Reset Bluetooth module (exact wording varies by macOS version).
  3. Confirm — Mac may restart Bluetooth stack immediately.
  4. Re-pair all accessories from scratch.

If the Debug menu is missing, macOS may have removed it in your version — use plist reset below.

3) Delete Bluetooth preferences (advanced)

Backup first. Quit apps using Bluetooth, then Terminal:

sudo rm /Library/Preferences/com.apple.Bluetooth.plist
sudo rm ~/Library/Preferences/com.apple.Bluetooth.plist

Restart the Mac (full shutdown on Apple Silicon recommended). Pairing database rebuilds empty — all devices forgotten system-wide for your user and globally for system plist.

4) Apple Silicon vs Intel differences

Both use the same plist paths and Shift+Option debug menu where available. Apple Silicon Macs integrate AirPods via Apple Account — after reset, sign-in may auto-offer nearby AirPods; Intel Macs pair as generic Bluetooth audio. Apple Silicon firmware updates for Magic accessories sometimes ship with macOS updates — check System Settings → General → Software Update after Bluetooth reset if Magic Keyboard/Mouse act dead.

Intel Macs with third-party USB Bluetooth dongles (rare on MacBooks) bypass the internal module — reset internal Bluetooth only affects built-in controller.

5) SMC / power-cycle notes

Intel Macs with persistent Bluetooth after plist reset: SMC reset may help (procedure varies by model — T2 Macs differ from pre-T2). Apple Silicon has no user-accessible SMC — full shutdown and 30-second wait replaces that step.

6) USB3 interference

2.4 GHz mice and keyboards drop when USB3 hubs sit nearby — move dongles to ports away from busy storage devices. Reset fixes software pairing; interference needs physical layout change.

7) When reset does not help

Accessory works on iPhone but never on Mac after reset — suspect hardware failure on the Mac’s Bluetooth antenna or the accessory itself. Test another Bluetooth device on the Mac. Internal failure on Apple Silicon requires Apple service; USB Bluetooth adapter is a temporary workaround on desktop Macs with available ports.

Verify

Accessory pairs, survives sleep/wake, audio or input stable five-plus minutes; Bluetooth menu shows Connected without cycling to Not Connected.

Related guides

bluetooth macos troubleshooting