uBlock Origin - An efficient blocker for Chromium and Firefox. Fast and lean.
Find a file
Raymond Hill 0aa0d81caf
[mv3] Re-work specific cosmetic filtering-related content scripts
To minimize delay to First Contentful Paint. The idea is to avoid
complex data structures such as Map in order to speed up first content
script execution. Use stringified arrays where practical and
instanciate those arrays from their stringified representation only
when there are actual cosmetic filters to apply.

Related commit:
https://github.com/gorhill/uBlock/commit/6039ef2b6d
2025-12-05 08:54:34 -05:00
.github Lower maintenance burden: Drop assets that never result in feedback 2025-09-08 14:40:45 -04:00
assets New address for Estonian list (#3944) 2025-10-23 08:45:46 -04:00
dist New revision for dev build 2025-11-28 14:33:44 -05:00
docs Fix typos in README, docs, and JS comments 2022-03-13 08:56:26 -04:00
platform [mv3] Re-work specific cosmetic filtering-related content scripts 2025-12-05 08:54:34 -05:00
publish-extension@9e03b41c86 [mv3] Re-work specific cosmetic filtering-related content scripts 2025-12-05 08:54:34 -05:00
src [mv3] Generate at most two scriptlet-related files per rulesets 2025-12-04 12:57:25 -05:00
tools [mv3][safari] Workaround for user styles issue with bfcache 2025-10-11 14:46:35 -04:00
.gitignore Update .gitignore 2025-01-04 20:41:28 -05:00
.gitmodules Move publish scripts in their own repo for easy reuse 2025-08-25 15:26:56 -04:00
CHANGELOG.md Update changelog 2025-11-28 15:07:25 -05:00
CONTRIBUTING.md Update contributing guide 2024-11-01 16:33:22 -04:00
eslint.config.mjs Better integrate latest eslint version 2025-01-10 10:25:15 -05:00
LICENSE.txt first commit 2014-06-23 18:42:43 -04:00
Makefile Update makefile 2025-10-30 09:02:38 -04:00
MANIFESTO.md Update MANIFESTO.md (#3888) 2023-04-15 15:42:12 -04:00
package-lock.json Update npm 2025-09-01 10:10:03 -04:00
package.json Move publish scripts in their own repo for easy reuse 2025-08-25 15:26:56 -04:00
README.md Update README.md 2025-09-07 08:39:45 -04:00
REMOVED.md Added data about old popup panel 2022-11-08 16:53:04 -05:00

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
Get uBlock Origin for Opera Opera Add-ons
Get uBlock Origin for Chromium Chrome Web Store About Google Chrome's "This extension may soon no longer be supported"
End of support on Chrome 139
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.

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.

Thunderbird

Thunderbird Add-ons

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

Chromium

Chrome Web Store

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

Opera Add-ons

Development Builds

uBO should be compatible with any Chromium-based browser.

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.