This repository is dedicated to the resources for uBlock Origin (uBO). It serves as a hub for reporting new filters or existing filters that may cause webpage breakage. Contributions are welcome, and valuable contributors may be granted write permissions to the repository.
The rationale for including specific filters in uBO's filter lists aligns with the EasyList/EasyPrivacy policies and considers whether a filter requires uBO's extended filter syntax.
It is preferred to address filter issues in EasyList first. Any filters included in uBO's filter lists must utilize the extended syntax.
High-traffic websites will have EasyList-compatible fixes added to uBO filters until they are incorporated into EasyList.
uAssets will address the following exceptions even if they do not require the extended syntax:
- Ad-Reinsertion
- Anti-Blocker
- Context Menu/Dev Console Blockage
- Cut/Copy/Paste/Drag Blockage
- Popups/Popunders
- Website Breakage
- Resource Abuse/Coin Mining
- Video/Audio Ads
- Redirections/URL Parameter Removing
uAssets will not address the following:
- Paywalls
- Porn Farms
To report an issue correctly:
- Disable all other browser extensions to see if the problem persists.
- If the issue continues:
- On the problematic website, click the uBlock Origin icon.
- Click the chat icon.
- Click "Troubleshooting Information" to expand, and copy that information into the relevant GitHub issue.
For support, questions, or assistance, visit /r/uBlockOrigin.
For issues related to uBO, please report them in the uBO issue tracker.
For issues specific to the Manifest Version 3 (MV3) variant, report them in the uBOL issue tracker.
Do NOT use any other similarly-purposed blockers concurrently with uBO, as this may lead to website breakage or unpredictable results.