To clear the WhatsApp Desktop unexpected error on a Mac, update WhatsApp on both the iPhone and the Mac, quit and reopen the Mac app, then link again from Linked devices > Link device on the iPhone and scan a fresh QR code.
This guide covers the exact linking steps on an iPhone 16 Pro or any iPhone, the limits that make a link fail, and fixes grouped by when the error appears.
How to fix unexpected error in WhatsApp Desktop on Mac
Most linking errors come from an outdated app on one side or a stale QR code session. Updating both apps and starting a fresh link fixes the common cases.
- On the iPhone, open the App Store, search for WhatsApp and tap Update if it appears.
- On the Mac, update WhatsApp from the App Store the same way.
- Quit WhatsApp on the Mac completely with Command + Q, then open it again.
- On the iPhone, open WhatsApp and tap Settings or your profile picture.
- Tap Linked devices > Link device.
- Unlock with Face ID, Touch ID or your phone passcode when asked.
- Point the iPhone at the QR code now showing on the Mac and scan it.
- If WhatsApp asks you to confirm an unrecognized device, tap Link device.
WhatsApp releases updates regularly, and they can contain fixes for bugs such as a failed link, so the update step matters even when the app looks current.
Why WhatsApp is not working on desktop: causes and fixes
| When the error appears | Likely cause | What to do |
|---|---|---|
| Right after scanning the QR code | Outdated app on the iPhone or Mac, or an expired QR code | Update both apps, reopen the Mac app, scan a new code |
| When tapping Link device | Identity check did not complete | Unlock with Face ID, Touch ID or the phone passcode again |
| After linking worked for a while | The primary phone has not opened WhatsApp for 14 days | Open WhatsApp on the iPhone, then relink the Mac if needed |
| When adding the Mac as another device | Four devices are already linked | Remove an old linked device, then link the Mac |
| On every attempt, on any network | Damaged or old Mac app install | Delete the Mac app, reinstall it from the App Store, link again |
WhatsApp linked devices requirements for Mac and iPhone
| Requirement | Detail |
|---|---|
| Primary phone | The iPhone that holds your WhatsApp account, with WhatsApp installed and signed in |
| Device limit | Up to four linked devices per account |
| Staying linked | Open WhatsApp on the primary phone at least every 14 days |
| Identity check | Face ID, Touch ID or the iPhone passcode on iOS 14 or later |
| App versions | Current WhatsApp on both the iPhone and the Mac |
Unexpected error WhatsApp desktop iPhone: reinstall the Mac app
Reinstalling replaces a damaged WhatsApp Mac app without touching the account on your iPhone. The iPhone remains the primary device, so your chats stay on it.
- Quit WhatsApp on the Mac with Command + Q.
- Open Finder and select Applications in the sidebar.
- Drag WhatsApp to the Trash.
- Open the App Store on the Mac, search for WhatsApp and install it.
- Open WhatsApp on the Mac and wait for the QR code.
- On the iPhone, tap Linked devices > Link device and scan the code.
Check WhatsApp Desktop is linked to your iPhone
- On the Mac, confirm your chat list loads instead of the QR code screen.
- On the iPhone, open WhatsApp and tap Settings or your profile picture, then Linked devices.
- Confirm the Mac appears in the list of linked devices.
- Send a test message from the Mac and check it appears in the same chat on the iPhone.
Some linked devices show less than a year of older chat history. WhatsApp lists this as a known issue, and the full history stays on the iPhone.
WhatsApp unexpected error, please link again: fixes
WhatsApp unexpected error please link again after a few weeks
Linked devices disconnect when the primary phone has not used WhatsApp for 14 days.
- Open WhatsApp on the iPhone and let it load your chats.
- On the Mac, quit and reopen WhatsApp.
- If the QR code shows, tap Linked devices > Link device on the iPhone and scan it.
Unexpected error WhatsApp desktop right after scanning the QR code
The code expired during the scan, or one app is out of date.
- Update WhatsApp on the iPhone and the Mac from the App Store.
- Quit the Mac app with Command + Q and reopen it to get a new code.
- Hold the iPhone steady so the whole code fits in the scanner, then scan again.
WhatsApp error something went wrong when adding the Mac
The account already has four linked devices, or the device check was cancelled.
- On the iPhone, open Linked devices and review the list.
- Remove a device you no longer use.
- Tap Link device, complete Face ID or the passcode, and scan the Mac's code.
WhatsApp Desktop Mac linking FAQ
How do I fix the unexpected error in WhatsApp Desktop?
Update WhatsApp on the iPhone and the Mac, quit and reopen the Mac app, then go to Linked devices > Link device on the iPhone and scan the new QR code. Reinstall the Mac app if the error returns.
Why is WhatsApp not working on desktop?
The desktop app depends on the primary phone, because of how WhatsApp works across devices. It disconnects when the phone has not opened WhatsApp for 14 days, when an app is out of date, or when the account already has four linked devices.
What happened to WhatsApp Desktop on my Mac?
If WhatsApp Desktop shows a QR code or asks you to link again, the link to your iPhone ended. Open WhatsApp on the iPhone, then link the Mac again from Linked devices.
Is the error specific to iPhone 16 Pro?
No. The linking steps and limits are the same on every iPhone that runs WhatsApp, so the same fixes apply to an iPhone 16 Pro and older models.
How many devices can I link to WhatsApp?
You can link up to four devices to one WhatsApp account using your primary phone. Remove an old device first if the Mac fails to link and four are already listed.
Will relinking WhatsApp Desktop delete my chats?
No. Your chats stay on the primary iPhone. A newly linked Mac syncs message history from the phone, though some linked devices show less older history than the phone.
