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
Dashboard: Filter lists
The Filter lists 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.
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".
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 according to the Expires directive (minimum interval is 1 day), or every 5 days by default.
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, which will reset "last update" timestamp for this list, remove its content from storage, and cause the "Update now" button to become available for use:
Note: "uBlock filters" entry is special - forcing update of this filter list, will also update additional resources when possible (library of resources used by Scriptlet injection, allowed to be updated on Chromium browser and develpment buils).
Purge all caches
This will reset "last update" timestamp for all of the subscribed 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.
Clicking this button with Ctrl and Shift pressed will remove all locally cached content of filter lists, which will force uBO to rebuild all of its databases from the beginning.
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: place check mark next to "Import..." in the "Custom" section and paste the URL of where a filter lists can be fetched from in the text area that appears. 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.