-
Notifications
You must be signed in to change notification settings - Fork 3k
Toolbar icon
The toolbar icon of uBlock Origin (uBO) informs you about the state of uBO and what it is doing.
The normal state of uBO is to be enabled and fully ready to filter, which is represented by the usual uBO icon:
:
The toolbar icon badge reports the number of network requests blocked on the current webpage.
If you disable uBO for a given site, the toolbar icon will be grayish, which indicates that no filtering will occur:
When you launch uBO, it needs to load all settings and filter lists in memory to be able to filter properly. When uBO is not yet ready to filter properly, the toolbar icon will be yellowish:
uBO's dashboard might be blank / white / inaccessible during that time.
A yellowish toolbar icon badge !
means some network requests were fired by the browser while uBO was not ready to filter properly, potentially leading to ads/trackers/etc. not being filtered in some of the already opened webpages:
The yellowish badge !
will persist once uBO is ready to filter properly, to remind you that the current webpage was not properly filtered:
To address the improper filtering that occurred on a webpage, you can simply force a reload of that webpage, which as a result will bring back the badge to be rendered as expected.
If you do not force a reload of the page, the yellowish badge will time out after ~1 minute, having accomplished its duty of warning you about the incomplete filtering.
The sticky yellowish badge once uBO is fully loaded affects only Chromium-based browsers because Chromium lacks the framework to ensure extensions are ready before firing network requests. This is a browser limitation, not an extension issue.
Firefox does not suffer this issue. See uBlock Origin works best on Firefox / Browser launch.
uBlock Origin - An efficient blocker for Chromium and Firefox. Fast and lean.
- Wiki home
- About the Wiki documentation
- Permissions
- Privacy policy
- Info:
- The toolbar icon
- The popup user interface
- The context menu
-
Dashboard
- Settings pane
- Filter lists pane
- My filters pane
- My rules pane
- Trusted sites pane
- Keyboard shortcuts
- The logger
- Element picker
- Element zapper
-
Blocking mode
- Very easy mode
- Easy mode (default)
- Medium mode (optimal for advanced users)
- Hard mode
- Nightmare mode
- Strict blocking
- Few words about re-design of uBO's user interface
- Reference answers to various topics seen in the wild
- Overview of uBlock's network filtering engine
- uBlock's blocking and protection effectiveness:
- uBlock's resource usage and efficiency:
- Memory footprint: what happens inside uBlock after installation
- uBlock vs. ABP: efficiency compared
- Counterpoint: Who cares about efficiency, I have 8 GB RAM and|or a quad core CPU
- Debunking "uBlock Origin is less efficient than Adguard" claims
- Myth: uBlock consumes over 80MB
- Myth: uBlock is just slightly less resource intensive than Adblock Plus
- Myth: uBlock consumes several or several dozen GB of RAM
- Various videos showing side by side comparison of the load speed of complex sites
- Own memory usage: benchmarks over time
- Contributed memory usage: benchmarks over time
- Can uBO crash a browser?
- Tools, tests
- Deploying uBlock Origin
- Proposal for integration/unit testing
- uBlock Origin Core (Node.js):
- Troubleshooting:
- Good external guides:
- Scientific papers