Onion links fail to load when you're using outdated version 2 (v2) addresses, which Tor Browser stopped supporting in August 2021 (1). To fix this:
Update Tor Browser to Support v3 Onion Addresses
Tor Browser stopped supporting version 2 onion services in August 2021. If you're trying to access older 16-character .onion addresses, they will not load. Tor Browser 10.5.4 included a warning that v2 onion service support would end very soon and urged users to migrate to version 3 onion services (1). Only version 3 (v3) onion addresses with 56 characters now work.
Version 2 addresses look like examplesite1234.onion with 16 random characters before the .onion suffix. Version 3 addresses are much longer: exampleabcdefghijklmnopqrstuvwxyz234567abcdefghijklmnopqr.onion with 56 characters. The longer format provides stronger cryptographic security and is the only standard Tor Browser now accepts.
Why Older Browser Versions Cause Loading Issues
Earlier Tor Browser versions had limited v3 onion service availability. Tor Browser 10.0.10 released on February 4, 2021 included a backported patch that increased the availability of v3 onion services (2). If you're running an older version, you may experience connection failures even with valid v3 addresses. The browser simply lacks the protocol improvements needed to reliably reach these services.
How to Check Your Tor Browser Version
Open Tor Browser and click the hamburger menu (three horizontal lines) in the top-right corner. Select Settings, then scroll down to Tor Browser Updates at the bottom. Your current version appears there. If it shows any version below 10.5.4, you're at risk of v2 compatibility issues. Versions below 10.0.10 also have reduced v3 availability.
Update to the Latest Version
Download the latest Tor Browser from the official Tor Project website. Do not use third-party download sites. After installation, restart the browser and revisit the onion link. If the address is a v3 format and the site is online, it should now load. For collections of verified v3 addresses, see Onion Links Directory.
Check for Known Onion Service Bugs in Your Tor Browser Version
Recent Tor Browser releases have fixed specific bugs that prevented onion sites from loading correctly. If you've updated to support v3 addresses but still experience failures, a known bug in your version may be the cause.
Tor Browser 13.5 released on June 20, 2024 changed how onion site errors appear. Onion site errors now display differently from other types of network errors (4). This distinction helps you determine whether the problem is with the specific onion service (the site may be offline or the address incorrect) or with your Tor network connection (circuit building issues). If you see an onion-specific error message, the site itself is likely unavailable. If you see a general network error, your Tor connection may have failed.
Bug Fixes in Version 13.5
Tor Browser 13.5 also fixed Bug 42557, which addressed a regression in Onion Services authentication prompt focus (5). This bug caused authentication prompts for password-protected onion sites to behave incorrectly. If you were unable to enter credentials or the prompt appeared unresponsive, this fix resolves the issue. Users accessing private onion services should update to version 13.5 or later to avoid authentication failures.
Bug Fixes in Version 14.0
Tor Browser 14.0 released on October 22, 2024 included bug fixes related to Fluent migration for onion services (3). These fixes improved how onion service messages and prompts are displayed in the browser interface. If you experienced garbled text, missing labels, or incorrectly formatted error messages when loading onion sites, updating to version 14.0 resolves these display issues.
How to Identify if a Bug Matches Your Symptoms
Check the Tor Browser release notes for your current version. Compare the bugs described there with the behavior you're seeing. If authentication prompts freeze, error messages appear unclear, or onion sites fail to load while clearnet sites work normally, a version-specific bug is likely. Update to the latest release and test the same onion link again. For additional troubleshooting steps, see Tor Links Not Loading: Common Causes and Fixes.
Distinguish Between Onion Site Errors and Network Issues
Tor Browser 13.5 released on June 20, 2024 introduced a change that helps you diagnose loading failures. Onion site errors now appear different from other types of network errors (4). This distinction tells you whether the problem is with the specific onion service you're trying to reach or with your Tor network connection itself.
What Onion-Specific Errors Mean
When you see an error message that identifies the onion site as the source of the problem, the issue is not with your browser or connection. The onion service may be offline, temporarily unavailable, or the address you entered may be incorrect. In this case, you cannot fix the problem on your end. Wait and try again later, or verify the address from a trusted directory. If the address is correct and the site remains unreachable for days, the service may have shut down permanently.
What General Network Errors Mean
If the error message indicates a network or connection problem rather than an onion site issue, your Tor circuit failed to build or your connection to the Tor network was interrupted. This type of error suggests you should troubleshoot your Tor Browser settings, check your internet connection, or verify that your ISP is not blocking Tor traffic. The onion service itself is likely online, but you cannot reach it due to connectivity issues on your side.
How to Interpret the Error Message
Read the error text carefully. Onion-specific errors typically mention the .onion address or state that the service is unavailable. General network errors refer to circuit building, consensus document retrieval, or bootstrap failures. If you're unsure which type of error you're seeing, restart Tor Browser and try loading a known-working onion site from a verified directory. If that site loads, the original address is the problem. If it also fails, your Tor connection needs troubleshooting. For detailed connection fixes, see Dark Web Links Not Working: How to Fix Onion Site Connection Errors.
Common Onion Link Error Messages: Root Causes and Quick Fixes
| Error Message or Symptom | Root Cause | Browser Version Affected | One-Line Fix |
|---|---|---|---|
| 16-character .onion address fails to load | Version 2 onion service no longer supported | All versions after August 2021 | Replace with 56-character v3 address |
| Onion site unavailable or address incorrect | Onion service offline or wrong address | All versions (error display improved in 13.5+) | Verify address from trusted directory or wait |
| Circuit building or bootstrap failure error | Tor network connection issue on your side | All versions (error display improved in 13.5+) | Restart Tor Browser or check internet connection |
| Authentication prompt unresponsive or frozen | Bug 42557 regression in authentication focus | Versions before 13.5 (June 2024) | Update to Tor Browser 13.5 or later |
| Garbled text or missing labels on errors | Fluent migration bug for onion services | Versions before 14.0 (October 2024) | Update to Tor Browser 14.0 or later |
| v3 onion sites load slowly or fail intermittently | Limited v3 availability in older versions | Versions before 10.0.10 (February 2021) | Update to Tor Browser 10.0.10 or later |
Q&A
- How do I access a .onion website?
Download and install Tor Browser from the official Tor Project website, then paste the full .onion address into the address bar. Only 56-character version 3 (v3) onion addresses work, as Tor Browser stopped supporting 16-character v2 addresses in August 2021 (1). If the site fails to load, verify the address is v3 format and check that your browser version is 10.0.10 or later for reliable v3 availability (2).
- Why does my Tor Browser not load?
Tor Browser may fail to load onion sites due to outdated browser versions, unsupported v2 addresses, or Tor network connection failures. Update to the latest version to resolve known bugs: version 13.5 fixed authentication prompt issues (5), and version 14.0 fixed display bugs for onion service messages (3). Check the error message to determine if the problem is the onion service itself (site offline or wrong address) or your Tor connection (circuit building failure) (4).
- Is Tor onion legal?
Using Tor Browser and accessing .onion sites is legal in most countries, including the United States. The technology itself is a privacy tool used by journalists, activists, and individuals seeking anonymity. However, the legality of specific activities you perform on onion sites depends on local laws—illegal actions remain illegal regardless of the network you use.
- Is it safe to open onion links?
Opening onion links in Tor Browser is safer than accessing them in a regular browser, but the safety of the destination site depends on its content and your behavior. Tor Browser isolates onion sites and blocks many tracking methods, but malicious onion sites can still host malware, phishing pages, or illegal content. Only visit onion addresses from trusted directories, avoid downloading files from unknown sources, and never enter personal information on unverified sites.
- Why can't I open .onion sites on Tor?
You cannot open .onion sites if you're using a 16-character v2 address, which Tor Browser stopped supporting in August 2021 (1). Other causes include outdated browser versions with limited v3 availability (2), known bugs in versions before 13.5 that affected authentication prompts (5), or Tor network connection failures. Update to the latest Tor Browser version, verify you're using a 56-character v3 address, and check the error message to determine if the issue is the onion service or your connection (4).
Key Takeaways
Version 2 onion addresses no longer work: Tor Browser stopped supporting 16-character v2 addresses in August 2021 (1). Only 56-character v3 addresses load now.
Update your browser to fix known bugs: Version 13.5 fixed authentication prompt issues (5), and version 14.0 resolved display bugs for onion service messages (3). Versions before 10.0.10 have reduced v3 availability (2).
Read error messages to diagnose the cause: Onion-specific errors mean the site is offline or the address is wrong. General network errors mean your Tor connection failed (4).
Verify addresses from trusted directories: If an onion link fails repeatedly, confirm the v3 address is current and the service is still operating.
Distinguish between service and connection problems: Test a known-working onion site to determine if the issue is your Tor network or the specific address you're trying to reach.
If you've updated your browser and verified the address format but still experience failures, check Dark Web Links Not Working: How to Fix Onion Site Connection Errors for detailed connection troubleshooting steps.
References
[1] New Release: Tor Browser 10.5.4 (Windows, macOS, Linux) | The Tor Project
[2] New Release: Tor Browser 10.0.10 | The Tor Project
[3] New Release: Tor Browser 14.0 | The Tor Project
Where to look next
These services are useful starting points for further research. Tools & services.