← All open source projects

uBlock Origin

gorhill/uBlock

uBlock Origin is a Chromium and Firefox extension for blocking unwanted requests and page elements.

Forks 4,179
Author gorhill
Language JavaScript
License GPL-3.0
Synced 2026-06-20

What it is

uBlock Origin is a browser extension for blocking ads, trackers, and other unwanted page elements. It is known for its focus on efficiency: less unnecessary work, lower memory use, and fast filtering.

It is more than an “ad off” button. It includes filter lists, network rules, cosmetic filtering, logging, and manual controls, so users can stay with defaults or inspect pages in detail.

How filtering works

A page loads scripts, images, styles, frames, and data from many addresses. uBlock Origin checks those requests and page elements against filter rules. Some things are blocked before loading; others are hidden or changed on the page.

That matters for privacy and usability because many pages load not only ads, but also behavior measurement, third-party widgets, popups, and heavy scripts.

Simplified flow

This is not the real rule syntax. It shows where the extension sits between a page, network requests, and visible elements.

Language: Plain text
page opens
  -> network request for script, image, frame
  -> filter lists check the request
  -> blocked request never reaches the page
  -> cosmetic filters hide matching page elements
  -> logger helps inspect what happened

What is inside

The repository contains extension code, build scripts, contributor documentation, release material, and translation work. Supporting several browser environments makes compatibility and platform boundaries important.

The value is not only code but also discipline around rules. A blocker must be fast, predictable, and careful: rules that are too broad break sites; rules that are too weak miss unwanted resources.

Strengths

The main strength is the combination of efficiency and control. Most people use default lists, while advanced users can inspect logs, enable additional lists, and tune rules.

Another reason for its popularity is reputation. The project has long developed as an independent user-focused tool rather than as part of the advertising ecosystem.

Limits

The extension depends on browser capabilities. When the browser extension platform changes, the limits of what a blocker can do also change.

Site compatibility is another issue. Aggressive filtering can break checkout, login, comments, or embedded widgets, so it helps to understand the logger and disable rules for a page when needed.

Where it helps

uBlock Origin is useful for people who want a cleaner and faster web, and for developers or researchers who want to see what third-party resources a page loads.

For site owners it is also a reminder: heavy trackers and intrusive inserts are part of the user experience, even when the page layout looks fine.