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
Filter syntax extensions
This version of uBlock is no longer under development.
Consider using uBlock Origin or another adblocker.
uBlock Origin: https://github.com/gorhill/uBlock
Other adblockers and privacy tools:
Please note that donations sought on ublock.org are not benefiting uBlock Origin developers.
uBlock supports most of the Adblock Edge / Adblock Plus filter syntax. However uBlock does not support some very specific cases, and also has its own extensions added to the ABE/ABP filter syntax.
Not supported. The purpose of the
document option is to disable uBlock completely. The reason it is not supported is to be sure that users explicitly disable uBlock themselves if they wish (through whitelisting), and not have some external filter list decide for them.
uBlock extends Adblock Edge / Adblock Plus filter syntax.
The filter option
important means to ignore all exception filters (those prefixed with
It applies only to net block filters. The
important option will allow you to block with 100% certainty specific net requests.
||google-analytics.com^$important,third-party will block all net requests to
google-analytics.com, disregarding any existing network exception filters.
To specifically disable inline script tags in a main page:
Entity-based cosmetic filters: Filters which are to be applied to a specific entity.
An entity is defined as follows: a formal domain name with the Public Suffix part replaced by a wildcard.
google.* will apply to all similar Google domain names:
facebook.* will apply to all similar Facebook domain names:
Since the base domain name is used to derive the "entity",
google.evil.biz would not match