Skip to content

Dashboard: 3rd party filters

Raymond Hill edited this page Aug 22, 2017 · 30 revisions

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.

The more filter lists one add, the higher the likelihood some web pages may not render properly, due to higher probability of false positives. When this occurs, you should report the issue to the maintainers of the filter list causing the issue, or create your own exception filters to fix the issue.

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.

When you hover the cursor over the clock icon of a filter list, a tooltip will tell you when the list was last updated. If you click the clock icon, uBO will mark the list as out-of-date. Lists which are out of date will be automatically updated in the background eventually when you check the option "Auto update filter lists". You can force out-of-date lists to be immediately updated by clicking "Update now".

Related: "Launch and filter lists load performance".


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).

Filter lists are automatically updated roughly every 5 days by default, or according to the Expires directive present in some filter lists.

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.

When a filter list has been updated using a newer version from its remote location, a clock icon will be present aside the filter list. You can force an update of a single filter list by clicking the clock icon of that filter list only. This will cause the "Update now" button to become available for use:

Purge all caches

This will remove all locally cached copies of 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 if you disable this option, your own custom cosmetic filters (if any) will still be enforced.

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