> ## Documentation Index
> Fetch the complete documentation index at: https://clapvo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# QR code not loading

> Steps to take when the QR pairing screen fails to load.

Pairing relies on a real-time socket connection to Clapvo. If the QR does not appear or never refreshes, the socket is the usual suspect.

## Common causes

* Browser extensions blocking the socket (ad blockers, privacy extensions, content blockers)
* A corporate firewall or VPN blocking WebSocket traffic
* A flaky network dropping the connection
* An outdated browser

## Steps to fix

<Steps>
  <Step title="Refresh the page">
    Close any ongoing pairing and start over.
  </Step>

  <Step title="Disable extensions">
    Try in an incognito or private window where extensions are off by default.
  </Step>

  <Step title="Try a different browser">
    Switch from Chrome to Firefox (or vice versa) to rule out a browser-specific issue.
  </Step>

  <Step title="Check your network">
    If you are on corporate Wi-Fi or VPN, try a different network. WebSocket blocking is common in restrictive networks.
  </Step>

  <Step title="Update your browser">
    Older browsers may not support modern WebSocket features.
  </Step>
</Steps>

## Tips

* The QR refreshes periodically. If yours expired, just wait for a new one to appear.
* If you see a **disconnected** indicator in the layout, fix that first - the QR will not load while the socket is down.

## Related

* [Connect WhatsApp](/docs/getting-started/connect-whatsapp)
* [Add a connection](/docs/product/connections/add-connection)
* [Contact support](/docs/support/contact-support)