Version 6 (modified by antonela, 2 years ago) (diff)

add TBA

Tor Browser Circuit Display


The circuit display is a user interface component available in Tor Browser which its main aim is to inform users about how the tor circuit for the current website has been made.

Typically, users will request a new circuit when page loading time is longer than what is expected or when they have any rendering problems with the exit node. Many users were hoping the guard node to change when asking for a new circuit. The problem we tried to solve is related to a new circuit request and how users understand the circuit visualizer. Previously, there was no indicator on the circuit display to show the user that the first node is a guard, what guards are, and what happens when Tor creates new circuits for a user.

Relevant Ticket(s)

Old UI

In the past, the circuit display was hanging from the Tor Button. Users reported in our trac ticketing system, that they were confused by the fact that every time they asked for a “New identity” or “New circuit for this site,” the first Tor node in the circuit remains the same.

Additionally, it was confusing for users whether the new circuit request would apply per site or globally. Also, we got reports about some inconsistencies with the browser user interface.

New UI

In order to move domain related controls to the URL bar, we decided to move the Circuit Display to the Control Center panel in Tor Browser 8.

The guard node, which is the first node of the circuit, has a label now. This acts as a highlight to help users to have a visual clue about which is the first node of the connection.

When a user clicks the [i] identity icon at the url bar, then the Control Center panel opens.

User Testing


The circuit display is a user interface component that educates users about how the tor network works. We want to keep this component as one of the tools that defines the Tor browsing experience.

This tool needs to be clear, transparent and consistent explaining its purpose.


As part of the global south initiative, we visited users from India, Uganda, Colombia, and Kenya to meet the people we are designing for and discover their needs. We ran a small-scale, short, qualitative, open-ended user test.

Read more about our Global South Initiative.



Ticket Status Summary Owner Reporter
#32973 needs_information Display real/starting IP address in the Tor Circuit information tbb-team PROTechThor
#30922 new Circuit Display not shown in some cases tbb-team acat
#30302 new Cleanup maps in tor-circuit-display tbb-team acat
#30290 new Circuit Display is lost when moving tab to a new window tbb-team acat
#30097 new Circuit UI not shown in FTP pages tbb-team acat
#29497 needs_information After tor crash, firefox.exe (tor browser) shoots up to 50+% cpu usage and stays there til killed in task list tbb-team cypherpunks
#28605 new OMG! Guard node only! tbb-team omg
#27590 assigned Display .onion alt-svc route in the circuit display tbb-team mahrud
#27447 new also show ip address of destination at tor circuit tbb-team h1n1
#26648 new Add bridge country to circuit display where applicable tbb-team gk
#26322 new Circuit display - UI bug - Long v3 name tbb-team antonela
#26176 new Display .onion services with "mixed" content in circuit display properly tbb-team gk
#23875 new Facebook's onion site is a single hop onion, but clicking on the Tor onion icon shows that it is a 6 hop circuit. tbb-team Dbryrtfbcbhgf
#19335 new Tor circuit display shows example circuit instead of real tbb-team axdoomer
#18583 new Tor Browser doesn't show the circuit for downloads tbb-team teor
#16936 new Circuit display should show original circuit for each tab tbb-team arthuredelstein
#15239 new Add hyperlinks in tor circuit display to show "more info" about relays tbb-team arthuredelstein
#14939 new Support ipv6 addresses in Tor Circuit DIsplay tbb-team arthuredelstein

Attachments (1)

Download all attachments as: .zip