Telegram Web Not Working: Fixes

When Telegram Web is not working, the cause is usually on your side: a browser extension blocking scripts, broken or blocked site data, an outdated browser, or a network that blocks Telegram. Start by opening Telegram Web in a private window with extensions off; if it works there, the problem is your normal browser profile. If it does not, check your network and the official address you are using.

This guide breaks the problem down by symptom and by cause. Each cause has a way to recognise it, numbered steps to fix it, and what to try if the fix does not work.

Before you start: the two-minute checks

Many problems disappear with these quick checks. Do them in order before working through the longer sections.

1. Check the address. The official web app lives at web.telegram.org. Type it yourself. Look-alike addresses are a common way to steal accounts.
2. Reload the page fully. Use a hard reload (on most computers, Ctrl+Shift+R, or Cmd+Shift+R on a Mac) to bypass the cached copy.
3. Try a private or incognito window. Extensions are usually off there and site data starts fresh. If it works, the cause is in your normal browser profile.
4. Try another browser. If Telegram Web works in a different browser, the first browser is the problem.
5. Check whether the Telegram app works on your phone. If the phone app also cannot connect, the problem is probably your network or a wider outage, not the browser.
6. Check the time on your computer. A clock that is far off breaks secure connections.

Write down what you saw at each step. The pattern tells you which section below applies.

Understanding Telegram Web

Telegram Web is the browser version of Telegram. It is a full Telegram app that runs in a tab: it connects to Telegram's servers, keeps a session for your account and stores data in your browser so it can load quickly next time.

Two versions

Telegram has offered two web versions built by different teams, often shown with the letters K and A in the address or settings. Both connect to the same account and the same chats. They look a little different and support slightly different features. If one version misbehaves, switching to the other is a legitimate fix; the option to switch usually appears in the web app's main menu.

Why the web version breaks more often than the apps

An installed app controls its own environment: its storage, its network code and its updates. Telegram Web lives inside your browser and inherits everything the browser does. Every extension you install, every privacy setting you tighten, every browser update and every rule your network applies to websites can affect it. That is why most of the fixes below are about the browser rather than about Telegram, and why a private window in another browser is such a useful test: it removes nearly all of those influences at once.

What it depends on

• A modern browser with current web technologies switched on.
• Site storage, so the browser can keep your session and cached chats.
• A network that can reach Telegram's servers.
• JavaScript, because the whole app is a script.

Most failures come from one of these four. Our guide to Telegram on Desktop and Web explains the setup in general; this guide is for when it goes wrong.

Symptom finder

Match what you see to the causes most likely behind it:

• Blank or white page, nothing loads: extensions, JavaScript disabled, outdated browser, hardware acceleration, corrupted site data.
• Page loads but stuck on "Connecting" or "Waiting for network": network blocks, VPN or proxy problems, a temporary outage.
• Login screen loads but QR code never appears or never works: network blocks, extensions, the phone not scanning correctly.
• Login code never arrives: the code goes to your Telegram app, not by SMS.
• Logged out every time you close the browser: site data being deleted, private mode, cookie settings.
• Chats load but photos or videos do not: storage full, extensions, codec support, network.
• No notifications: browser or system notification permissions.
• Suddenly logged out: the session was ended from another device or expired.

Cause 1: A browser extension is blocking it

How to recognise it

Telegram Web works in a private window (where extensions are usually off) but not in your normal window. Ad blockers, script blockers, privacy tools and some antivirus browser extensions are the usual suspects, because Telegram Web loads its whole interface through scripts and connects to its servers in ways these tools sometimes misread.

How to fix it

1. Open your browser's extensions page.
2. Turn off all extensions.
3. Reload Telegram Web with a hard reload.
4. If it now works, turn extensions back on one at a time, reloading after each, until it breaks again.
5. For the extension that breaks it, add web.telegram.org to its allow list, or keep it disabled on that site.

If that does not work

Some security software works outside the browser, at system level. Temporarily pause your antivirus web protection, test once, then turn it back on and add an exception for Telegram's web address if it was the cause. Do not leave protection off.

Cause 2: Broken or blocked site data

How to recognise it

Telegram Web shows a blank page or loads endlessly in your usual browser profile, but works in a private window, even with extensions off. Or it logs you out every time you close the browser. Both point to site storage: either corrupted data from an earlier version, or settings that block or delete it.

How to fix corrupted data

1. Open Telegram Web.
2. Open the site information panel (usually the padlock or site icon left of the address).
3. Choose the option for site settings or site data.
4. Clear data and cookies for web.telegram.org only.
5. Reload and log in again.

Clearing site data logs you out of Telegram Web on that browser. Your chats are not deleted; they are in the cloud and load again after login.

How to fix storage being blocked or wiped

1. In your browser's privacy settings, check whether all cookies or all site data are blocked. If so, add an exception allowing web.telegram.org.
2. Check whether the browser is set to clear cookies and site data when it closes. Add an exception for Telegram Web if you want to stay logged in.
3. Check whether a cleaner app on your computer wipes browser data automatically.

If that does not work

Create a fresh browser profile and try there. If it works in a new profile, something in your old profile's settings is the cause, and moving to the new profile may be quicker than finding it.

Cause 3: An outdated or unsupported browser

How to recognise it

The page loads partly, shows layout errors, or displays a message that your browser is not supported. This is common on older computers, older versions of Safari on macOS that can no longer update, and browsers built into other apps.

How to fix it

1. Open your browser's About page; most browsers check for updates there.
2. Install any available update and restart the browser.
3. If your browser cannot update further, install a different current browser.
4. Avoid using Telegram Web inside another app's built-in browser; open it in a full browser.

If that does not work

If the computer's operating system is too old for any current browser, Telegram Web may not run well on it. Telegram Desktop is an installed app that may work better on older hardware, or use the phone app. Our comparison of Desktop, Web and mobile explains the trade-offs.

Cause 4: JavaScript or a required feature is switched off

How to recognise it

A completely blank page, or a message asking you to enable JavaScript. Some privacy-focused browser settings turn off features Telegram Web needs, such as JavaScript, web storage or certain network features.

How to fix it

1. In your browser settings, find the JavaScript or site permissions section.
2. Make sure JavaScript is allowed, at least for web.telegram.org.
3. If you use a hardened privacy browser or strict privacy mode, try the browser's standard mode for this site.
4. Reload.

If that does not work

Try another mainstream browser in its default settings. If Telegram Web works there, the first browser's privacy settings are too strict for it; decide whether you prefer to loosen them for this site or use a different browser for Telegram.

Cause 5: Stuck on "Connecting" or "Waiting for network"

How to recognise it

The interface appears, maybe with old chats, but the top of the screen keeps saying it is connecting, and new messages do not arrive. The phone app on the same network may have the same problem.

How to fix it

1. Check that other websites load. If nothing loads, fix the internet connection first.
2. If you are on a work, school, hotel or public network, try a different network, such as your phone's hotspot. Many managed networks block messaging services.
3. Turn off any VPN or proxy and test again. Some VPN servers are blocked or slow for Telegram; if it works without the VPN, try a different server.
4. If Telegram is restricted in your country, a reliable VPN may be the only way to reach it. Follow local law; our guide to where Telegram is banned or restricted gives background.
5. Restart your router if every device at home has the problem.

If that does not work

Telegram occasionally has outages in some regions. If the phone app also fails on several networks, wait a while and try again. Our guide to Telegram stuck on connecting covers this symptom on all platforms, including proxy settings in the installed apps.

Cause 6: Your computer's clock is wrong

How to recognise it

You see security or certificate warnings, or many secure websites fail, not just Telegram. Sometimes Telegram Web just refuses to connect without a clear error. A computer clock that is far off makes secure connections look invalid.

How to fix it

1. Open your computer's date and time settings.
2. Turn on automatic time and time zone.
3. Make sure the date, not just the time, is correct.
4. Restart the browser and reload Telegram Web.

If that does not work

If the clock keeps resetting after a restart, the computer's internal battery or sync settings may be at fault. That is a computer repair issue; until it is fixed, set the time manually each session.

Cause 7: Login problems

Logging in to Telegram Web works in one of two ways: scanning a QR code with your phone's Telegram app, or entering your phone number and a code.

The QR code does not appear or keeps refreshing

How to recognise it: the login page loads but the QR area stays empty or spins.

1. Wait a moment; the code refreshes itself periodically.
2. Turn off extensions and reload.
3. Check your network, as in Cause 5. The code is fetched from Telegram's servers.
4. Switch to logging in by phone number if the QR code still fails.

Scanning does nothing

How to recognise it: your phone scans the code but the browser does not log in.

1. Scan from inside the Telegram app on your phone, not with the phone's normal camera app. In the Telegram app, look for the option to link a desktop device in Settings, usually under Devices.
2. Make sure the phone has a working connection.
3. Make sure the whole code is in view and the screen brightness is high enough.
4. If you use two-step verification, the browser will ask for your password after scanning; enter it there.

Our guide to logging in with a QR code explains each step in more detail.

The login code never arrives

How to recognise it: you entered your number, and no SMS comes.

1. Open Telegram on your phone or another logged-in device. When you are already logged in somewhere, the code is usually sent there, in a chat from Telegram's official account, not by SMS.
2. Check that you typed the number with the correct country code.
3. Wait before requesting again; asking repeatedly can trigger a temporary block.

If you have no other logged-in device, see Telegram not sending login code and, if you see a waiting message, too many attempts.

The two-step password is not accepted

Passwords are case-sensitive and must be typed exactly. Check your keyboard layout and caps lock. If you have forgotten it, use the recovery option linked to your recovery email. Never ask anyone else to reset it for you.

Cause 8: Photos, videos or files will not load

How to recognise it

Chats and text load, but images show placeholders, videos do not play or downloads fail.

How to fix it

1. Check your network speed; media is much larger than text.
2. Turn off extensions and test again, since some block media requests.
3. Check free disk space. Browsers stop storing data when the disk is nearly full.
4. Clear Telegram Web's site data, as in Cause 2, to remove a damaged cache.
5. For videos that load but will not play, try another browser. Browsers differ in which video formats they can play.

If that does not work

Open the same chat in the phone app. If the media fails there too, the file may be unavailable or the problem is wider; see Telegram videos not playing and slow download speed.

Cause 9: No notifications from Telegram Web

How to recognise it

Messages arrive when you look at the tab, but you get no desktop alert.

How to fix it

1. Click the site icon next to the address and check that notifications are allowed for web.telegram.org.
2. In Telegram Web's own settings, check that notifications are enabled.
3. Check your operating system's notification settings for the browser itself. Windows and macOS can silence a browser entirely.
4. Check focus or do-not-disturb modes on the computer.
5. Keep the Telegram Web tab open. Closing the tab, or the browser, stops notifications.

If that does not work

Browsers may put background tabs to sleep to save power, which can delay notifications. Exclude Telegram Web from tab sleeping in your browser's performance settings, or use Telegram Desktop, which handles notifications as an installed app. For notification problems on phones as well, see Telegram notifications not working.

Cause 10: A blank screen from graphics problems

How to recognise it

The page loads but appears white, black, flickering or garbled, especially on older graphics hardware or after a graphics driver update. Other heavy websites may show the same behaviour.

How to fix it

1. Update your browser and your graphics drivers.
2. In the browser's system settings, turn off hardware acceleration (sometimes called "use graphics acceleration when available").
3. Restart the browser and test.

If that does not work

Turn hardware acceleration back on if it made no difference, so other sites are not slowed. Try the other version of Telegram Web, which renders differently, or Telegram Desktop.

Cause 11: You were logged out unexpectedly

How to recognise it

You open Telegram Web and see the login screen, although you did not log out.

What may have happened

• The session was ended from another device. Someone, possibly you, terminated it in Settings under Devices.
• The session expired because of the automatic setting for inactive sessions.
• Site data was cleared by the browser, an extension or a cleaner app.
• You were in a private window, which forgets everything when closed.

What to do

1. Log in again.
2. Open Settings, then Devices, on your phone and look through the list. If you see sessions you do not recognise, end them and set up two-step verification.
3. If site data keeps being cleared, apply the exception steps in Cause 2.

Our guide to logging out of all devices explains how sessions work and how to review them.

Cause 12: A wider outage

How to recognise it

Telegram fails in the browser and on your phone, on more than one network, and friends report the same.

What to do

1. Wait. Outages are usually resolved without any action from users.
2. Avoid logging out or clearing data during an outage; you may struggle to log back in until it ends.
3. Check Telegram's official channels from another device or ask friends in another country whether it works for them.

Cause 13: Telegram Web open in several tabs or windows

How to recognise it

You opened Telegram Web in more than one tab, or in two browser windows, and one of them stops updating, shows a notice about being open elsewhere, or behaves oddly. The web app is designed to run as one active copy per browser, because two copies sharing the same stored data can get in each other's way.

How to fix it

1. Close every Telegram Web tab except one.
2. Reload the remaining tab.
3. If you want Telegram in two places on one computer, use Telegram Web in one browser and Telegram Desktop, or a different browser, for the other.

If that does not work

Clear site data for web.telegram.org, as in Cause 2, to reset any confused state, then log in again in a single tab.

Cause 14: One web version misbehaves

How to recognise it

A specific feature fails, such as a button that does nothing, a type of message that will not display or a setting that will not save, while everything else works. This is often a bug in one of the two web versions rather than a problem with your setup.

How to fix it

1. Open the main menu in Telegram Web and look for the option to switch to the other version.
2. Switch and log in if asked. Your chats are the same in both.
3. Test the feature in the other version.

If that does not work

Check whether the same feature works in the phone app or Telegram Desktop. If it works there, use that for now; web versions are updated regularly and the bug may be fixed soon. If it fails everywhere, the feature itself may be temporarily broken or not available for your account.

What to do next if nothing works

If you have worked through every cause and Telegram Web still fails, collect what you know before asking for help:

1. Which browser and version you used, and which other browsers you tried.
2. Whether a private window, another network and the phone app worked.
3. Any exact error text on the screen.
4. When it started, and whether anything changed around then, such as a browser update, a new extension or a new network.

With that list, you can describe the problem in a few lines. Our guide on how to contact Telegram support explains where to send it and what to expect. In the meantime, Telegram Desktop or the phone app will usually let you keep chatting while the browser problem is investigated.

Using Telegram Web on a phone or tablet

Telegram Web can be opened in a mobile browser, which is handy on a borrowed device. It is not designed to replace the apps, so some features are limited, and mobile browsers sleep background tabs aggressively, which stops notifications. If Telegram Web on a phone misbehaves, the official app from your app store is the reliable fix. On a shared or borrowed device, remember to log out afterwards.

Fake Telegram Web sites

Because people search for "Telegram Web", scammers create look-alike sites that copy the login page. When you enter your number, code and password there, they get your account.

• Only use web.telegram.org, typed by hand or from a bookmark you created.
• Do not follow "Telegram Web" links from ads, messages or search results without checking the address.
• If you entered your code on a suspicious site, open Settings, then Devices, on your phone, end unknown sessions, and change your two-step password straight away. Our guide to recovering a hacked account covers the rest.

Worked examples

Example: works at home, fails at the office

Telegram Web loads at home but stays on "Connecting" at work. The phone app also fails on office Wi-Fi but works on mobile data. The office network blocks Telegram. The fix is to use mobile data or ask the IT team; a VPN may break the workplace's rules, so check before using one.

Example: blank page after a browser update

After a browser update, Telegram Web shows a white page in the normal window but works in a private window. Turning off extensions does not help; clearing site data for web.telegram.org does. The old cached data was incompatible with the updated web app.

Example: logged out every morning

Someone is logged out of Telegram Web every day. Their browser is set to delete cookies and site data on exit. Adding an exception for web.telegram.org keeps them logged in, while other sites are still cleared.

Example: no notifications on a laptop

Notifications are allowed in the browser, but the laptop's focus mode silences all browser alerts during work hours. Turning off focus mode for the browser, or using Telegram Desktop, brings notifications back.

Common mistakes

• Clearing all browser data when only Telegram's needs clearing. That logs you out of every site.
• Leaving extensions on while testing. One extension can hide every other fix.
• Requesting login codes repeatedly. It can lead to a temporary block.
• Searching for "Telegram Web" and clicking the first result. Check the address every time.
• Assuming chats are lost after clearing site data. They are in the cloud and come back after login.
• Using a private window and expecting to stay logged in. Private windows forget everything when closed.

FAQ

Why does Telegram Web say "Waiting for network" when my internet works?

Your network may block Telegram, a VPN or proxy may be interfering, or there may be a regional outage. Try another network, such as your phone's hotspot, and turn off any VPN to test.

Is Telegram Web the same as Telegram Desktop?

No. Telegram Web runs in a browser tab; Telegram Desktop is an installed app. They share your account and chats but are separate sessions with different settings.

Will clearing Telegram Web's data delete my chats?

No. Cloud chats stay in your account. Clearing site data only logs out that browser. Secret chats are not available on Telegram Web in the first place.

Why does the QR code not work when I scan it with my camera?

Telegram Web's QR code must be scanned from inside the Telegram app on your phone, from the option for linking a desktop device, not with the phone's normal camera.

Can I use Telegram Web without my phone?

You can log in with your phone number and a code. The code is usually sent to another logged-in Telegram device; if you have none, it may come by SMS.

Which browser works best with Telegram Web?

Any current version of a major browser should work. If one misbehaves, try another before spending time on deeper fixes.

Summary

Telegram Web depends on four things: a current browser, working site storage, JavaScript and a network that can reach Telegram. Test in a private window and another browser to find which one is failing, then fix it: disable extensions, clear site data for web.telegram.org only, update the browser, correct the clock, or switch networks. Log in by scanning the QR code from inside the Telegram app, look for login codes in your other Telegram sessions, and only ever use the official address. If nothing works and the phone app fails too, it is probably an outage, and waiting is the fix.