Skip to content
This repository was archived by the owner on Sep 9, 2022. It is now read-only.

Filter syntax extensions

Alexander Pushkov edited this page Nov 10, 2017 · 21 revisions

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

document:

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.

Extended syntax

uBlock extends Adblock Edge / Adblock Plus filter syntax.

Network filters

important:

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.

Example 1: ||google-analytics.com^$important,third-party will block all net requests to google-analytics.com, disregarding any existing network exception filters.

Example 2: ||twitter.com^$important,third-party

inline-script:

To specifically disable inline script tags in a main page: ||example.com^$inline-script.

Cosmetic filters

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.

Example 1: google.* will apply to all similar Google domain names: google.com, google.com.br, google.ca, google.co.uk, etc.

Example 2: facebook.* will apply to all similar Facebook domain names: facebook.com, facebook.net.

Since the base domain name is used to derive the "entity", google.evil.biz would not match google.*.

Clone this wiki locally
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy