uBlock README

The project's README from github.com/gorhill/uBlock. As one markdown file: README.md.

Badge Commits Badge Issues Badge Localization Badge License Badge NPM Badge Mozilla Badge Chrome Badge Edge


uBlock Origin (uBO)

Browser Install from ... Status
Get uBlock Origin for Firefox Firefox Add-ons uBO works best on Firefox
Get uBlock Origin for Microsoft Edge 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."
Get uBlock Origin for Opera Opera Add-ons
Get uBlock Origin for Chromium 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"
Get uBlock Origin for Thunderbird Thunderbird Add-ons No longer updated and stuck at 1.49.2. Later versions require "GitHub - Releases".
Get uBlock Origin through GitHub 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 for Chromium and Firefox. It blocks ads, trackers, coin miners, popups, annoying anti-blockers, malware sites, etc., by default using EasyList, EasyPrivacy, Peter Lowe's Blocklist, Online Malicious URL Blocklist, and uBO filter lists. There are many other lists available to block even more. Hosts files are also supported. uBO uses the EasyList filter syntax and extends 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

Basic Mode Advanced Mode
The simple popup user interface for an install-it-and-forget-it type of installation that is configured optimally by default. The advanced popup user interface includes a point-and-click firewall that is configurable on a per-site basis.

Visit the Wiki for documentation.

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

Installation

Required Permissions

Firefox

Firefox Add-ons

Development Builds

uBO works best on Firefox and is available for desktop and Android versions.

Chromium

Chrome Web Store: Removed on 2026-08-31

Microsoft Edge Add-ons (Published by Nicole Rolls until version 1.62. Ownership transfer at version 1.64.)

Opera Add-ons

uBO should be compatible with any Chromium-based browser.

Thunderbird

Thunderbird Add-ons

In Thunderbird, uBlock Origin does not affect emails, just feeds.

All Programs

Do NOT use uBO with any other content blocker. uBO performs as well as or better than most popular blockers. Other blockers can prevent uBO's privacy or anti-blocker-defusing features from working correctly.

Manual Installation

Enterprise Deployment

Deploying uBO

Release History

Releases Page

Translations

Help translate uBO via Crowdin.

About

Manifesto

Privacy Policy

GPLv3 License

Free. Open-source. For users by users. No donations sought.

If you ever want to contribute something, think about the people working hard to maintain the filter lists you are using, which are available to use by all for free.

uBlock (gorhill/uBlock)

Searching Database…

68.6K ·GitHub
What is this?uBlock Origin (uBO) is a free, open-source browser extension that blocks ads, trackers, coin miners, popups, anti-blockers, and malware sites in Chromium and Firefox.
Is this one extension or different builds per browser?It is the same extension distributed separately for each browser store (Firefox, Edge, Opera) plus manual builds for other Chromium browsers and Thunderbird.
Is it still on the Chrome Web Store?No. All remaining Manifest V2 extensions, including uBO, were removed from the Chrome Web Store on August 31, 2026, so Chromium users now need manual installation and won't get auto-updates.
Which browsers does it actually support?It works on Firefox desktop and Android (its best-supported platform), any Chromium-based browser, Microsoft Edge, Opera, and Thunderbird (where it only filters feeds, not emails).
What does it block by default and can I change that?By default it uses EasyList, EasyPrivacy, Peter Lowe's Blocklist, the Online Malicious URL Blocklist, and uBO's own filter lists, plus hosts-file support; any of these lists can be unchecked if you think it blocks too much.
Is it really free, no catch?Yes, it is fully free and open source under GPLv3, with the project explicitly stating it seeks no donations.
What is the difference between Basic and Advanced Mode?Basic Mode is an install-and-forget setup configured optimally by default, while Advanced Mode adds a point-and-click firewall you can configure per site.
Can I run uBO alongside another ad blocker?No, the project advises against it: other blockers can interfere with uBO's privacy and anti-blocker-defusing features, even though uBO alone performs as well as or better than most popular blockers.
Does uBO affect my Thunderbird emails?No, in Thunderbird uBlock Origin only filters RSS/Atom feeds and does not touch emails.
Does the author consider ad blocking to be theft?No, the README explicitly rejects that framing, arguing blocking is a defense of the inalienable right to privacy against privacy-invading tracking methods, not theft.
Creator
gorhill
Size
156.2 MB
Stars
68.6K
Age
11y
Commits · 90 Days