Most onion links stopped working because you're trying to access old v2 onion addresses (16-character format), which became completely unreachable in October 2021 when Tor Browser 11.0 removed v2 support (1). All onion services now require v3 addresses (56-character format). If all onion sites fail to load, check your Tor connection, system clock synchronization, or try bridges if you're in a censored network.
Understanding Why V2 Onion Addresses No Longer Work
If you bookmarked an onion link years ago and it now shows "Invalid Onion Site Address," the problem is almost certainly that it's a v2 onion address. Tor Browser 11.0, released on November 8, 2021, made v2 onion services completely unreachable (1). These older addresses stopped working permanently in October 2021 when Tor Browser moved to version 0.4.6.x (2).
What Changed in October 2021
The Tor Project announced on July 2, 2020, that v2 onion service support would be removed from the code base in version 0.4.6.x on July 15, 2021, with client-side disabling planned for October 15, 2021 (3). Starting with Tor 0.4.6.8, v2 onion addresses are treated as bad hostnames that Tor cannot use, rather than simply deprecated addresses (4). This means your Tor Browser doesn't even attempt to connect—it rejects the address immediately.
Tor Browser began warning users who visited v2 onion sites about their upcoming retirement starting with the 10.5 release series in 2021 (1). If you ignored those warnings or haven't updated your bookmarks, every v2 link you saved will now fail.
How to Identify V2 vs V3 Addresses
The difference is visible in the address length:
V2 onion address: 16 characters before .onion (example format:
abcdefghijklmnop.onion)V3 onion address: 56 characters before .onion (example format:
thehiddenwiki...longstring...d.onion)
All onion services must now use v3 format (2). If your saved link is 16 characters, it will never work again in any current Tor Browser version. You need to find the updated v3 address from the service's clearnet website, verified directories like Onion Links Directory, or community forums that track migrations.
How to Find Updated V3 Onion Addresses
When v2 onion addresses became completely unreachable in October 2021, onion site administrators were required to upgrade to v3 onion services (2). Most legitimate services published their new v3 addresses, but you need to know where to look.
Check the Service's Clearnet Website First
Many onion services maintain a clearnet (regular internet) website that lists their current v3 onion address. This is the most reliable method. Visit the service's official domain using a regular browser and look for an "onion address" or "Tor access" section, usually in the footer or FAQ.
If you don't remember the clearnet domain, search for the service name plus "official site" or "onion address" using a standard search engine. Avoid clicking ads or unverified results—phishing sites often impersonate popular onion services.
Use Verified Onion Directories
Curated directories track working v3 addresses and remove outdated links. Check resources like Onion Links Directory or similar verified collections that document migrations from v2 to v3. Community-maintained lists on Tor-focused forums often include migration notices when a service updates its address.
Directories that haven't been updated since 2020 will contain only dead v2 links. Look for directories with recent update timestamps or version notes mentioning v3 migrations.
Search Tor-Focused Communities
Reddit communities focused on Tor, privacy forums, and specialized discussion boards often share updated addresses when services migrate. Users typically post announcements like "Service X moved to new v3 address" with the updated link.
Verify Addresses Through Multiple Trusted Sources
Never trust a single source for an onion address. Cross-reference the v3 address across at least two independent trusted sources—the official clearnet site and a verified directory, for example. Phishing sites create fake v3 addresses that look legitimate but steal credentials or distribute malware.
If you find conflicting addresses, assume both are suspicious until you verify through the service's official clearnet presence or a cryptographically signed announcement.
Other Common Reasons Onion Links Fail
If you've confirmed the address is v3 format (56 characters) but the onion link still won't load, the problem isn't the address version—it's either the specific service or your Tor connection.
The Onion Service Is Offline
Self-hosted onion services frequently shut down without notice. Unlike clearnet websites hosted on commercial servers with uptime guarantees, most onion services run on personal computers or temporary infrastructure. When the operator turns off their machine, the service disappears immediately.
If only one or two specific v3 sites fail while others load normally, those services are likely offline. You can test this by visiting a known-working onion site like a major search engine or marketplace. If those load but your target doesn't, the service itself is down—not your connection.
Onion services don't have "down for maintenance" pages. They simply become unreachable. Check back later or search for announcements on the service's clearnet site or community forums.
Tor Circuit Failures
Sometimes your Tor circuit (the chain of relays routing your connection) fails to reach a specific onion service. This happens when guard relays or intermediate nodes drop packets or become overloaded.
Right-click anywhere on the page in Tor Browser and select "New Tor Circuit for this Site." This forces Tor to build a fresh path to the onion service. If the site loads after requesting a new circuit, the previous path was faulty—not the service.
System Clock Desynchronization
Tor's cryptographic handshakes require your system clock to match network time within a few minutes. If your computer's clock is wrong by more than an hour, Tor cannot verify hidden service descriptors or consensus documents from directory authorities.
Check your system time and date. If they're incorrect, synchronize your clock through your operating system's time settings (enable automatic time synchronization). Restart Tor Browser after fixing the clock. If all onion sites failed before and now load, clock desynchronization was the cause.
Outdated Tor Browser Version
Running an old Tor Browser version can prevent connections to newer onion services or cause compatibility issues with Tor directory authorities. Download the latest Tor Browser from the official Tor Project website. Never update through third-party sites.
Connection Issues in Censored Networks
If you're in a country that blocks Tor (China, Iran, Turkmenistan, or others), your internet provider may be blocking direct connections to the Tor network. All onion sites will fail to load, and Tor Browser will show connection errors during startup.
You need bridge relays—unlisted Tor entry points that circumvent censorship. In Tor Browser, go to Settings > Connection > Bridges and select "Request a bridge from torproject.org" or choose a built-in obfs4 bridge. Bridges allow you to connect to the Tor network when standard guard relays are blocked.
If you're not in a censored region but all onion sites fail, check whether your local network (workplace, school, public Wi-Fi) blocks Tor traffic. Try connecting from a different network or use bridges.
How to Identify Which Issue Applies
All onion sites fail to load: Problem is your Tor connection—check system clock, update Tor Browser, or configure bridges.
Only specific v3 sites fail: Those services are offline. Test with a known-working onion site to confirm your connection works.
Error says "Invalid Onion Site Address": You're using a v2 address (16 characters). Find the updated v3 address.
Error says "Onionsite Not Found": Either the v3 service is offline or your circuit can't reach it. Try a new circuit.
For persistent connection issues across all onion sites, see Tor Links Not Loading: How to Fix Connection Issues for detailed troubleshooting steps.
Diagnostic Table: Onion Link Errors and Verified Fixes
| Error Message / Symptom | Exact Cause | How to Test | Fix | Verification Step |
|---|---|---|---|---|
| Invalid Onion Site Address | V2 onion address (16 characters), deprecated October 2021 | Count characters before .onion—16 means v2 | Find updated v3 address from clearnet site or verified directory | New address has 56 characters and loads successfully |
| Onionsite Not Found (specific v3 sites) | Service is offline or circuit failure | Visit known-working v3 site (search engine or marketplace) | Right-click page > New Tor Circuit for this Site | Site loads after new circuit, or remains down (service offline) |
| All onion sites fail to load | Tor connection issue: clock desync, outdated browser, or censorship | Check system clock accuracy (within minutes of network time) | Sync system clock, update Tor Browser, or configure bridges | Known-working v3 sites load after applying fix |
| Connection timeout during Tor startup | Censored network blocking Tor guard relays | Try connecting from different network (mobile data vs Wi-Fi) | Settings > Connection > Bridges > Request obfs4 bridge | Tor Browser connects and onion sites become accessible |
| Site loads intermittently | Circuit instability or overloaded relays | Reload page multiple times—inconsistent results indicate circuit issue | Request new circuit; if persists, service has uptime problems | Consistent loading after new circuit (circuit was cause) |
Q&A
- How to access .onion links?
Download Tor Browser from the official Tor Project website and install it on your computer. Open Tor Browser, wait for it to connect to the Tor network (usually 10–30 seconds), then paste or type the .onion address directly into the address bar. Only v3 onion addresses (56 characters before .onion) work—v2 addresses became completely unreachable in October 2021.
- Which browser can open onion links?
Only Tor Browser can open .onion links reliably. Standard browsers like Chrome, Firefox, Safari, or Edge cannot access onion services because they don't route traffic through the Tor network. Some privacy-focused browsers claim onion support through proxies, but these configurations often leak your real IP address or fail to connect—use official Tor Browser instead.
- How to open Onion links on iPhone?
Install Onion Browser from the iOS App Store (developed by Mike Tigas, the only Tor Project-recommended iOS app). Open the app, wait for the Tor connection to establish, then enter the v3 onion address in the address bar. Onion Browser provides weaker anonymity than Tor Browser on desktop because iOS restricts background network processes, but it's the most reliable option for iPhone users.
- How to access onion sites on Tor?
Launch Tor Browser and wait for the connection status to show "Connected to the Tor network." Copy the full v3 onion address (56 characters plus .onion) and paste it into the address bar—don't use a search engine for onion addresses, as most won't index them. If the site doesn't load, right-click the page and select "New Tor Circuit for this Site" to try a different routing path.
- Are onion links illegal?
Onion links themselves are not illegal in the US or most countries—they're simply addresses for websites hosted on the Tor network. The legality depends entirely on the content and activities on the site you access. Visiting news sites, privacy tools, or forums via onion addresses is legal, but accessing sites that distribute illegal content (child exploitation material, stolen data, illegal marketplaces) is a crime regardless of whether you use Tor.
- Is Tor legal or illegal in the US?
Tor is completely legal to download, install, and use in the United States. The Tor Project is a US-based nonprofit, and Tor Browser is used by journalists, activists, military personnel, and privacy-conscious individuals without legal consequence. Using Tor does not make your activities illegal—only the specific actions you take (accessing illegal content, conducting crimes) determine legality, just as with the regular internet.
Key Takeaways
V2 onion addresses (16 characters) stopped working completely in October 2021—you must find updated v3 addresses (56 characters) from the service's clearnet site or verified directories (1) (4).
If all onion sites fail, your Tor connection is broken—check your system clock synchronization, update to the latest Tor Browser, or configure bridges if you're in a censored network.
If only specific v3 sites won't load, those services are likely offline—test with a known-working onion site, then try "New Tor Circuit for this Site" by right-clicking the page.
Never trust a single source for onion addresses—cross-reference v3 links across the official clearnet website and at least one verified directory to avoid phishing sites.
Onion services shut down without warning—self-hosted sites disappear when operators turn off their machines, so bookmark multiple alternatives and check community forums for migration announcements.
If you need reliable starting points for working v3 addresses, see Onion Links Directory for verified collections updated after the v2 deprecation.
References
[1] New Release: Tor Browser 11.0 | The Tor Project
[2] The state of onion services & PrivChat #5
[3] Onion Service version 2 deprecation timeline | The Tor Project
[4] [tor-commits] [tor/main] hs: v2 address are now considered a bad hostname
Where to look next
These services are useful starting points for further research. Tools & services.