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.
- Ad-Reinsertion
- Anti-Blocker
- Context Menu Blockage
- Cut/Copy/Paste Blockage
- Popups/Popunders
- Website Breakage
- Video Ads
- Paywalls
- Porn Farms
- Annoyances (widgets, social media buttons, newsletter subscriptions, donation requests, etc)
-
Disable all other browser extensions and see if the issue still occurs
-
If the issue still occurs when all other browser extensions are disabled, then provide the troubleshooting information:
-
Steps for uBO:
- Open a new browser tab
- Go to the specific page where the issue occurs
- Click the 🛡️ uBO icon
- Click the 💬 chat icon
- Click
Troubleshooting Information - Click
Select alland copy the contents - Paste the contents into the appropriate GitHub thread
-
Steps for uBO Lite:
- Open a new browser tab
- Go to the specific page where the issue occurs
- Click the 🛡️ uBO Lite icon
- Click the menu item for
💬 Report an issue - Click
Troubleshooting Information - Copy the contents
- Paste the contents into the appropriate GitHub thread
-
New filter list requests in the issue tracker are not permitted and will be declined and closed.
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.