Skip to content

Dashboard: 3rd party filters

Raymond Hill edited this page Dec 23, 2015 · 30 revisions

Back to Wiki home


The 3rd-party filters pane is where you subscribe to filter lists. The filter lists to which you subscribe will feed uBlock Origin's static filtering engine.

The picture below shows uBlock Origin's default selection of filter lists. You can add more, or remove some of the filter lists already selected by default (for reference, most other blockers have only EasyList selected). If you remove filter lists, it is still strongly advised to at least keep uBlock filters selected: these filters are optimized for uBlock Origin.

3rd-party filter pane

uBlock Origin discards duplicate filters, so the number of filters used within a filter list depends on how many duplicate filters were detected within that filter list. The order in which the filter lists are loaded into memory is undefined.


Auto-update filter lists

If you check this option, uBlock Origin will update automatically the currently selected filter lists at regular interval. This option is checked by default (recommended).

Update now

This button is available for use if and only if there is at least one filter list which is deemed outdated. If this condition is fulfilled, you can force an update of all filter lists which are deemed out of date.

Purge all caches

This will remove all locally cached copies of filter the filter lists. Essentially, this will cause all filter lists to become out of date. This can be used to force an update of all filter lists.

Parse and enforce cosmetic filters

Un-check this option if you do not want cosmetic filters to be parsed and enforced. This option is mostly of interest for those who want to further reduce uBlock Origin's memory and CPU footprint. Cosmetic filtering has no value privacy-wise, its only purpose is to hide elements on a web page which can't be blocked otherwise. An example of this are the ads served with some Google Search results.

Note that disabling this option will also cause your own custom cosmetic filters (if any) to be ignored.

Stock filter lists

This is a collection of various filter lists, grouped by purpose. To use a specific filter list, just select it through its checkbox. Any change in the selection of filter lists must be committed by using the Apply change button, which will appear if and only if the current selection of filter lists differs from the previous selection of filter lists.


Important: The more filter lists are selected, the higher the likelihood of web site breakage. The quality of the selected filter lists also affects the likelihood of web site breakage. The EasyList-related filter lists are high quality filter lists, as they are actively maintained.


Custom filter lists

You can import custom 3rd-party filter lists: just paste in the text area the URL of where a filter lists can be fetched. These custom filter lists will be also automatically updated on a regular basis.

On some specific web pages, it is possible to subscribe to a 3rd-party filter list by simply clicking on a link to the filter list. There is such a page for uBlock Origin: Filter lists from around the web.

Clone this wiki locally