Skip to content

Dashboard: 3rd party filters

Raymond Hill edited this page Apr 13, 2016 · 18 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. When this occurs, you may want to 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.

The http label present for certain filter lists means these filter lists are not downloaded using secure connection -- because their respective servers do not support https.

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 4-5 days, or for uBO's own filter lists ("uBlock filters ..."), when a new version is available.

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 button purge cache will be available for that filter list. You can force an update of a single filter list by purging the cache of that filter list only -- by clicking its purge cache button. 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 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