-
Notifications
You must be signed in to change notification settings - Fork 81
How to whitelist a web site
I've read a couple of feedbacks of people who wish it was possible to whitelist a web site, i.e. to disable uBlock on a specific web site.
The feature is already available: it is the big power button. It serves to whitelist the current web site, and its state will be remembered next time you visit the web site.
All whitelist directives are matched against the URL address of web pages.
As of version uBlock 0.8.2.0, the whitelist directive syntax is split into three classes:
- Plain
- Complex
- Comment
Plain syntax is when using only hostname label(s), which means only the hostname portion of a URL will be taken into account. With plain syntax, the matching is performed by comparing the right-most portion of the page hostname with the whitelist directive. Wildcards are not allowed when using plain syntax.
Complex syntax occurs if and only if at least one /
appears in a whitelist directive. Optionally, the wildcard *
can be used with complex directives for more flexibility.
A comment is a line prefixed with #
. Comments are ignored by uBlock.
If no /
appears in a whitelist directive, and if the directive contains characters which are not allowed for a plain hostname, then the whitelist directive will be commented out and ignored by uBlock. This allows you to fix your directive.
-
example.com
: whitelist all pages fromexample.com
or above (i.e.example.com
,www.example.com
). -
www.example.org
: whitelist all pages fromwww.example.org
or above (i.e.www.example.org
,forums.www.example.org
, but notexample.org
). -
org
: whitelist all pages from TLDorg
(i.e.example.org
,wikipedia.org
).
-
http://www.twitch.tv/letofski
: whitelist only this one page, i.e. when the URL in the address bar matches exactlyhttp://www.twitch.tv/letofski
.
-
http://www.twitch.tv/letofski*
: whitelist this one page, and everything underneath, i.e. when the URL in the address bar starts exactly withhttp://www.twitch.tv/letofski
.
*reddit.com/r/privacy/*
Wildcards can be used at any position. However, when a wildcard is used within the hostname portion of a directive, it cannot be at the end of the hostname, and also must be at the boundary of a hostname label.
- Requirements:
- Chromium-based browsers: install Tampermonkey extension.
- Firefox-based browsers: install Greasemonkey extension.
- Install this user script.
- Read the instructions that come with the user script above.
If you re-enable uBlock by clicking the whitelist button in the popup while a whitelist directive you handcrafted is in effect, your handcrafted whitelist directive will simply be commented out. This way you can bring it back to life if ever you un-whitelist by mistake.
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