How to whitelist a web site

The big power button in the uBlock popup will whitelist the current website. Its state will be remembered the next time you visit the website.

Detailed syntax

All whitelist directives are matched against the URL address of web pages.

As of uBlock version 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 rightmost portion of the page hostname with the whitelist directive. Wildcards are not allowed when using plain syntax.

Complex syntax occurs when 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 lines 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 the directive.

Plain hostname

• example.org: whitelist all pages from example.org or above (i.e. example.org, www.example.org).
• www.example.org: whitelist all pages from www.example.org or above (i.e. www.example.org, forums.www.example.org, but not example.org).
• org: whitelist all pages from TLD org (i.e. example.org, wikipedia.org).

Single web page

• http://www.example.org/page: whitelist only this one page, i.e. when the URL in the address bar matches exactly http://www.example.org/page.

Section of a web site

• http://www.example.org/page*: whitelist this one page, and everything underneath it, i.e. when the URL in the address bar starts exactly with http://www.example.org/page.

Specific pattern

• *example.org/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.

A Youtube channel

• Follow steps 1 to 4 in "YouTube - whitelist channels in Adblock Plus"
• Extract the author's name as directed
• Once you have the author's name:
  • Go to the Whitelist tab in uBlock's dashboard
  • Add the line *youtube.com/*&user=[AUTHOR NAME]*
  • Replace [AUTHOR NAME] with the author name you extracted earlier
  • Example: *youtube.com/*&user=jacksfilms*

Other details

If you re-enable uBlock by clicking the whitelist button in the popup while a whitelist directive you created is in effect, your whitelist directive will simply be commented out. This way, you can quickly bring it back if you ever un-whitelist by mistake.