gorhill /uBlock

uBlock Origin - An efficient blocker for Chromium and Firefox. Fast and lean.

★ 69,224⑂ 4,442👁 1,047⑃ 428● 3,430▤ 293◈ 0
JavaScriptGPL-3.0Created 2015-04-01
69,224
stars
+27
4,442
forks
1,047
watchers
428
prs
3,430
issues
293
releases
0
discussions

README

[![Badge Commits]][Commit Rate]
[![Badge Issues]][Issues]
[![Badge Localization]][Crowdin]
[![Badge License]][License]
[![Badge NPM]][NPM]
[![Badge Mozilla]][Mozilla]
![Badge Chrome]
[![Badge Edge]][Edge]







uBlock Origin (uBO)


| Browser   | Install from ... | Status |
| :-------: | ---------------- | ------ |
|  | Firefox Add-ons | uBO works best on Firefox |
|  | Edge Add-ons | "Moving the Microsoft Edge extensions ecosystem forward with Manifest Version 3": "Beginning in August 2026, Microsoft Edge will start the consumer transition away from Manifest Version 2 (MV2) extensions and toward MV3. Our goal is to complete the consumer transition by the end of 2026, with enterprise deprecation following in early 2027." |
|  | Opera Add-ons |
|  | Removed | "Manifest V2 support timeline": "Aug 31st 2026: All remaining Manifest V2 extensions removed from the Chrome Web Store"About Google Chrome's "This extension may soon no longer be supported" |
|  | Thunderbird Add-ons | No longer updated and stuck at 1.49.2. Later versions require "GitHub - Releases". |
|  | GitHub - Releases | Stable and development versions on Firefox, Chromium MV2, and Thunderbird. Must be placed manually into web browsers; the Chromium and Thunderbird versions usually won't auto-update.

 Related: 



uBlock Origin Lite





uBlock Origin (uBO) is a CPU and memory-efficient [wide-spectrum content blocker][Blocking] for Chromium and Firefox. It blocks ads, trackers, coin miners, popups, annoying anti-blockers, malware sites, etc., by default using [EasyList][EasyList], [EasyPrivacy][EasyPrivacy], [Peter Lowe's Blocklist][Peter Lowe's Blocklist], [Online Malicious URL Blocklist][Malicious Blocklist], and uBO [filter lists][uBO Filters]. There are many other lists available to block even more. Hosts files are also supported. uBO uses the EasyList filter syntax and [extends][Extended Syntax] the syntax to work with custom rules and filters.

You may easily unselect any preselected filter lists if you think uBO blocks too much. For reference, Adblock Plus installs with only EasyList, ABP filters, and Acceptable Ads enabled by default.

It is important to note that using a blocker is NOT [theft]. Do not fall for this creepy idea. The _ultimate_ logical consequence of blocking = theft is the criminalization of the inalienable right to privacy.

Ads, "unintrusive" or not, are just the visible portion of the privacy-invading means entering your browser when you visit most sites. uBO's primary goal is to help users neutralize these privacy-invading methods in a way that welcomes those users who do not wish to use more technical means.



 Documentation
 Installation
   Firefox
   Chromium
   Thunderbird
   All Programs
   Enterprise Deployment
 Release History
 Translations
 About

 Documentation


    
        
            Basic Mode
            Advanced Mode
        
    
    
        
            The simple popup user interface for an install-it-and-forget-it type of installatio

Top issues

Latest release

1.76.0 1.76.0 2026-11-08
Commits to master since this release
Commits since last release

To install the stable build:

- Firefox: Install from AMO: 
    uBO works best on Firefox
- Chromium: Install directly from signed CRX package
- Edge: Install from Microsoft Store: 
- Opera: Install from Opera addons: 

---

- Prevent war:-related filters for the time being
- Validate about to be created filter in element picker
- Prevent re-entrancy with recursive operator in JSONPath
- [Improve [trusted-]edit-inbound-object scriptlet](https://github.com/gorhill/uBlock/commit/a20cfcebd8)
- Add support for iso-88

Snapshot: 2026-11-10T09:35:25Z · Data license Apache-2.0 · JSON