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

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

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

Report issues with uBO in the uBO issue tracker.

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

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