Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Quick guide: popup user interface
- The large power button
- The number of requests blocked
- The tools
- The number of domains connected
- The overview panel
- The per-site switches
This is uBlock's popup UI when you click on uBlock's icon in the toolbar:
The large power button
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".
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
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
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:
gstatic.com, example 2:
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|
|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:
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
The per-site switches allow you to control some settings on a per-site basis. See detailed documentation about per-site switches.