Skip to content
Troubleshooting

Fix Linked Device Connection Problems in WhatsApp Mods

A step-by-step checklist for linked-device problems in WhatsApp mods: network, date and time, the main phone, updating the mod and re-linking cleanly.

· 4 min read

Linked device mode lets you run a WhatsApp mod such as JTWhatsApp next to the official WhatsApp on your main phone. You scan a QR code from the main phone, and the mod works as a companion device. When it works, it is convenient. When it does not, you may see a QR code that never finishes, messages stuck on "connecting", or a session that logs itself out.

Most of these problems have ordinary causes. Work through the checklist below in order, because the early steps are quick and fix a surprising number of cases. Keep in mind that mods are unofficial and are not affiliated with WhatsApp or Meta, so no fix can promise a stable connection, and accounts that use modified clients can be restricted.

Before you start: protect your chats

In linked device mode your account lives in official WhatsApp on the main phone. Before changing anything:

  1. On the main phone, open Settings → Chats → Chat backup and make a fresh backup.
  2. Note which devices appear under Linked devices, so you can recognise them later.

The checklist

Step 1: Check the network on both phones

  1. Make sure both the main phone and the companion phone have a working internet connection. Open a web page on each to confirm.
  2. Switch between Wi-Fi and mobile data to rule out a problem with one network.
  3. Turn off any VPN, data saver or battery saver mode for a moment, since these can interrupt background connections.
  4. If you are on public or office Wi-Fi, try another network; some block certain connections.

Step 2: Fix the date and time

A wrong clock is a classic cause of connection failures, because secure connections depend on accurate time.

  1. On both phones, open the system Settings and find Date and time.
  2. Turn on automatic date and time, and automatic time zone if available.
  3. Restart the app after changing it.

Step 3: Keep the main phone online and active

The companion device depends on the main account. If the main phone is switched off, out of battery or has not been used for a long time, linked sessions can stop syncing or be logged out.

  1. Keep official WhatsApp installed and up to date on the main phone through Google Play.
  2. Open it regularly so the account stays active.
  3. Allow WhatsApp to run in the background: exclude it from aggressive battery optimisation in the system settings.

Step 4: Update the mod

Linking problems are often version problems. As WhatsApp changes, older mod builds can stop pairing properly.

  • JTWhatsApp V20 lists fixes for linking and companion-device login in its changelog.
  • GB WhatsApp version 20 lists improved device pairing on all Android phones and fixed connection problems.
  1. Check the version you have against the current one on the app's MODZILO page.
  2. Make a backup, then install the new APK over the old one without uninstalling first.
  3. Open the mod and see whether the connection returns before re-linking.

Step 5: Re-link cleanly

If the session is still broken, remove it and start again:

  1. On the main phone, open official WhatsApp and go to Linked devices.
  2. Tap the device that is not working and choose Log out.
  3. On the companion phone, open the mod. If it still shows an old session, log out or clear the session from the mod's own settings; the exact option name varies between versions.
  4. Choose the linked device option on the companion phone so it shows a QR code.
  5. On the main phone, tap Link a device and scan the code.
  6. Keep both phones on the same screen and connected until the chats finish loading. The first sync can take a while if you have a lot of history.

When nothing helps

  • Restart both phones. It clears stuck network states more often than you would expect.
  • Check free storage. A nearly full phone can fail while syncing chats.
  • Use the official app for now. If the mod will not link, official WhatsApp on the main phone keeps you reachable while you wait for the next update.

Key takeaways

  • Back up on the main phone before troubleshooting.
  • Check the network, then the date and time, on both phones.
  • Keep official WhatsApp updated, active and allowed to run in the background on the main phone.
  • Update the mod, because recent versions of JTWhatsApp and GB WhatsApp list linking fixes.
  • Re-link cleanly from Linked devices if the session stays broken, and remember mods remain unofficial.

Apps in this article

Keep reading