Quick guide: popup user interface

Raymond Hill edited this page Jul 23, 2018 · 113 revisions

Back to Wiki home

This is uBlock's popup UI when you click on uBlock's icon in the toolbar:

Popup UI

The large power button

Popup UI

Click the large power button to turn off uBlock for the current site (a.k.a. whitelist the current site). This will be remembered the next time you visit the site.

Alternatively, you can also Ctrl-click to turn off uBlock only for the current page (command ⌘-click on Mac).

For more advanced whitelisting control, see "How to whitelist a web site".

The tools


Zap an element on the current page

Click the flash icon to enter element zapper mode, which allows you to interactively remove one or more elements on the current page. Removing an element is always temporary, i.e. the removed elements will be back when the page is reloaded.

Create a filter for the current site

Click the eye-dropper icon to enter element picker mode, which allows you to create a filter by interactively picking an element on a page, thus permanently removing it from the page.

Open the logger

Click the list icon to open the logger in a separate tab. This allows you to inspect real-time network traffic within the browser.

Tip: press the Shift key while clicking the icon to toggle between opening the logger in a separate window or separate tab. uBO will remember that setting when you open the logger without the Shift key.

Open the dashboard

Click the sliders icon to open uBlock's dashboard.

The number of requests blocked

Popup UI

This shows the number of network requests uBlock blocked on the current page. Also, less useful (but people like this kind of thing), the number of network requests uBlock blocked since you installed it. The percentage figure tells you how many requests were blocked out of all the requests made.

The number of domains connected

Popup UI

The number of distinct domains with which a network connection was established, out of all connections (established + blocked). The domains are derived using the official Public Suffix List.

In general, it must be assumed that each distinct domain is managed by a distinct administrative authority. In practice, it is not uncommon to have a multiple distinct domains which are under the same administrative authority (example 1: google.com, ajax.googleapis.com and gstatic.com, example 2: wikipedia.org and wikimedia.org).

That said, this statistic may be seen this way: the more distinct domains your browser connects to, the greater the privacy exposure.

In a best-case scenario, the number of distinct domains to which a web page connects should be only one: that of the remote server from which the web page was fetched.

The higher the number, the higher you are exposing yourself privacy-wise.

There is a good correlation between the domains connected count and: unneeded page bloat, high privacy exposure, increased likelihood of being the target of data mining.

Example: the web page on http://www.ibtimes.com/ (which can be read fine in all cases, by the way):

uBlock's mode turned off default settings default-deny
domains connected
privacy exposure very high medium very low
bloat ridiculously high medium very low

And I had click-to-play enabled in all cases, so it could have been worse (except for default-deny)...

The overview panel

When you click on either the "requests blocked" or "domains connected" label, uBO's popup UI will expand* to show you more details about requests blocked and domains connected:

Click the all cell at the top to toggle on/off subdomain-level details.

The pluses and minuses denote network requests which were either allowed (not blocked) or blocked, respectively for the specific domain/hostname aside which they appear. The number of pluses and minuses are proportional to the number of requests allowed or blocked:

  • +, -: under 10 network requests were allowed, blocked.
  • ++, --: under 100 network requests were allowed, blocked.
  • +++, ---: 100 or more network requests were allowed, blocked.

To hide that panel, just click again on either the "requests blocked" or "domains connected" label.

Unless you are in "advanced user" mode, this panel is read-only and available only for informational purpose.

In "advanced user" mode, the panel is fully interactive and can be used for advanced filtering control.

* The panel will also be expanded when you enable "advanced user" mode -- this is only for convenience -- it will not close automatically when "advanced user" will be disabled.

The per-site switches

Popup UI

The per-site switches allow you to control some settings on a per-site basis. See detailed documentation about per-site switches.

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.