Go to file
ItsProfessional b7446aadfd move to q 2023-12-06 12:12:30 +05:30
.github add www 2023-11-10 15:47:12 +00:00
filters move to q 2023-12-06 12:12:30 +05:30
templates Have a slightly higher diff-expires time than server update cycle 2023-11-22 19:55:46 -05:00
thirdparties Update Easylist assets 2023-12-06 04:50:14 +00:00
tools Minor 2023-11-17 07:59:13 -05:00
.gitattributes GitHub Linguist support for adblock rules (#14699) 2022-09-09 07:20:18 -04:00
.gitignore Add tool to check for dead hostnames 2022-10-27 13:46:57 -04:00
CONTRIBUTING.md Update CONTRIBUTING.md 2016-04-06 14:56:41 -04:00
LICENSE Initial commit 2016-04-01 07:41:37 -04:00
Makefile adding 2023 2023-01-01 16:00:48 +01:00
README.md update last commit 2023-09-03 10:43:42 +02:00



This repository is for the resources of uBlock Origin (uBO). It receives all reports for new filters or existing filters that cause web page breakage. Any contributors are welcome. Contributors who are proven valuable will get write permissions to the repository.

The rationale for including a specific filter in uBO's filter lists is the same as the EasyList/EasyPrivacy policies and also takes into account whether a filter requires uBO's extended filter syntax.

It is preferred to fix filter issues in EasyList. Any filters included in uBO's filter lists must use the extended syntax.

The EasyList-compatible fixes for high-traffic websites are added to uBO filters until they become added to EasyList.

uAssets will fix the following exceptions even if they do not require using the extended syntax:

  • Ad-Reinsertion
  • Anti-Blocker
  • Context Menu Blockage
  • Cut/Copy/Paste Blockage
  • Popups/Popunders
  • Website Breakage
  • Video Ads

uAssets will not address the following:

  • Paywalls
  • Porn Farms

How to correctly report an issue

  • In options->Filter lists:

    • "Purge all caches"
    • "Update now"
  • Disable all other browser extensions and see if the problem still persists

  • How to provide troubleshooting information:

    If the problem persists, then please:

    • On the problematic website, click the uBlock Origin icon
    • Click the chat icon
    • Click "Troubleshooting Information" to expand, and copy that information into the appropriate github issue.

Support Forum

For support, questions, or help, visit /r/uBlockOrigin.

uBO Issues

Report issues with uBO in the uBO issue tracker.

uBO Lite (uBOL) Issues

Report issues specific to the Manifest Version 3 (MV3) variant in the uBOL issue tracker.

Similarly-Purposed Blockers

Do NOT use any other similarly-purposed blockers concurrently with uBO. It can result in website breakage or undefined results.