What the uBlock Origin icon colors and badge number mean

Ashwin Karthik
Updated •
Google Chrome

The uBlock Origin toolbar icon turns yellow, or shows a yellow exclamation mark, when the extension has not finished loading its filter lists, or when requests fired before it was ready. A normal icon with a number means filtering is active and the number counts blocked requests on the current page; the popup shows the same count with the percentage of the page's requests that were blocked. Reload the page to clear a yellow badge.

This page explains each icon state, why it happens in Chromium browsers, and how to change the setting that reduces it.

What do the uBlock Origin icon colors and badges mean?

uBlock Origin's toolbar icon has four states: normal, yellow (loading), yellow exclamation badge (some requests were not filtered) and gray (filtering off for the site). The project's own wiki describes them, and the color coding was introduced in uBlock Origin 1.48 in March 2023.

  • Normal icon with a number: uBlock Origin is ready, and the badge shows how many network requests it blocked on the current page.
  • Yellowish icon: uBlock Origin is still loading its settings and filter lists into memory and cannot filter properly yet. It usually clears within seconds after the browser starts.
  • Yellow exclamation badge: some requests were fired while uBlock Origin was not ready, so ads or trackers on pages that were already loading may not have been filtered.
  • Gray icon: filtering is switched off for the current site, so nothing is blocked there.

To hide the number, untick "Show the number of blocked requests on the icon" in the dashboard's Settings tab.

uBlock Origin toolbar icon showing a yellow badge while filter lists load

uBlock Origin button with a yellow badge

uBlock Origin button in its normal color, ready to filter

Why does the uBlock Origin icon turn yellow at browser launch?

The icon turns yellow because the extension needs a few seconds after the browser starts to load its filter lists, and Chromium browsers can begin loading restored tabs before that finishes. Requests from those tabs pass through unfiltered, so you may see ads right after launch even though the blocker is installed.

The browser, not the extension, causes the gap. The behavior became more noticeable in Chromium 110 (February 2023), which favored loading the tabs from your previous session. Firefox does not have this problem. The wiki notes the sticky yellow badge after loading affects only Chromium-based browsers.

The warning exists to explain missing blocking: uBlock Origin's 1.48.0 change log says the color coding was added to reduce user reports about ads at startup. A similar tab-suspension workaround for YouTube ads at launch appeared earlier in uBlock Origin 1.40.

How do I clear the yellow badge?

Reload the page. A reload sends the page's requests again through the now-ready extension and restores the normal badge. If you do nothing, the wiki says the yellow badge times out after about one minute, but the ads that already loaded stay on the page until you refresh it.

If the whole icon stays yellow for a long time, the filter lists are still loading or the extension failed to start. Wait briefly, then open the extension's dashboard, and if that does not help, disable and re-enable the extension or restart the browser.

How do I stop pages loading before uBlock Origin is ready?

Turn on the option "Suspend network activity until all filter lists are loaded" in uBlock Origin's dashboard. It makes the browser hold requests until the lists are in memory, so restored tabs no longer load unfiltered. It is on by default in Firefox, and you enable it yourself in Chromium-based browsers that still run uBlock Origin. Google Chrome has phased out Manifest V2 extensions, so current Chrome versions offer uBlock Origin Lite instead, which works differently.

  1. Click the uBlock Origin icon, then the Settings (dashboard) icon.
  2. Open the Filter lists tab (in some versions the option sits in the Settings tab).
  3. Tick "Suspend network activity until all filter lists are loaded".

uBlock Origin setting to suspend network activity until all filter lists are loaded

The trade-off is speed: with the option on, pages may load more slowly right after the browser starts, because they wait for the lists. Turn it off again if that bothers you. If you cannot find it, check both tabs of your version.

Version 1.48 first reached the Microsoft Edge add-ons store and Mozilla's add-on repository, with the change log on GitHub as the reference.

Related: YouTube showing ads with uBlock Origin enabled, removing page elements permanently with uBlock Origin, best Chrome ad blocker extensions

Comments

  1. MPA said on
    Reply

    I miss Netscape. It was everything you could want in a browser. I remember it also included setting up emails and newsgroups.

  2. Someone said on
    Reply

    i use both ublock and AdblockPlus. The second is very good, than uBlock that I’ve noticed some bugs instead. Only problem is the cookies pop-up banners.

    1. Tom Hawack said on
      Reply

      uBlock Origin AND AdblockPlus : never do that!
      You have all you need in uBO, you can enable/disable provided lists, add your own lists as well as filters and rules.
      Using another Adblock extension with uBO will not only lead to redundancy but to possible clashes (think of one blocked blocking and the other making an exception), and will inevitably slow down. Believe me : avoid that.

      1. basingstoke said on
        Reply

        It’s much easier to manage “permanent” removals of site elements with ABP, and even revert accidentally saved blocked items. I use ublock for passive stuff, and non-permanent zaps, hell, it’s zaps are better than ABP zaps, but ABP zaps are much easier to manage. I know you can do this with ublock but it seems to me to be far more obtuse.

      2. Tom Hawack said on
        Reply

        @basingstoke, I do agree that managing removals of style elements, in fact styling may be easier with another extension than uBO (though feasible with uBO) but then with a dedicated style extension : using ABP together with uBO, if it may be easier for styling site elements as you mention it, nevertheless has the drawback of being basically comparable to uBO and as I see it (and have read often) is NOT advised, be it by simple good sense : redundancy and possible clashes : i.e. if ABP says “Remove” and uBO says “Don’t remove” (@@exception for instance) then we face a race, possible slowdowns, inconsistency. I mean, they don’t go together because their action field is the same.

        Personally I use a Style Editor, ‘Stylish’ here, to remove, edit site elements. A Style Editor … styles, it’s not an AdBlocker, it won’t interfere with uBO. In some cases it’s faster than uBO when it comes to removing site elements : for instance there’s a uBO filter which blocks an ad’s area, that area may be blocked once the page is fully resolved …. whilst if I add a rule to ‘Stylish’ to perform that removal, the removal is done much faster than with uBO : I happen to remove with Stylish what uBO does with its ‘Cosmetic filtering’ just to avoid, you know, the element, because removed lately, making the page rendering less “smooth” :=)

        But the main thing is that we get along with our aspirations, if it works the way we like it then that’s the main thing. We all have our ways of, our little habits. There may be ultimate ways pros know, but we’re not all pros :=)

    2. Mystique said on
      Reply

      I don’t know about AdblockPlus being any better than uBlock origin (provided you are using the proper uBlock Origin) but it is clearly working for you. I feel like the doubling up is probably part of your problems that and maybe you could afford to add some additional filters to your filter lists such as the ones in the annoyance categories regardless of what you are using that will help you with your cookie problem or you could consider installing an extension such as “I still don’t care about cookies”. They might also have a filter list but I do not recall exactly.

  3. Mystique said on
    Reply

    Anyone would think google would want ads to slip through… funny that.
    Google always Googling.

  4. Shove your warnings... said on
    Reply

    “Warning: Enabling the option could negatively impact page loading performance at the browser’s launch. This issue only affects Chromium-based browsers.”

    DUHHHHHHH….

    The whole point is to block ads, I don’t care even if the browser would need a good 5 minutes to launch the first time just so I won’t see any ads, EVER.

  5. upp said on
    Reply

    Mozilla takes the review process very very seriously, not like Chrome which uses 100% automated bot and that’s why there is full of malware extensions from Chrome Store, as recent Save cookies.txt extension infected a whole subreddit of yt-dlp and it was removed from Chrome Store, but it still managed to steal so many bank accounts of many users..

    1. Anonymous said on
      Reply

      Not very serious when you found tons of malware lol. Check the Firefox subreddit.

      Btw you may not know, it’s free to publish in Firefox addon store but you need to pay to publish in Chrome addon store.

    2. Iron Heart said on
      Reply

      @upp

      Only a minor percentage of Firefox’s extensions are manually reviewed. The rest gets automatic reviews just like what happens on the Chrome Web Store.

  6. Graham said on
    Reply

    I just keep the icon hidden with the add-on running in the background. Out of sight, out of mind.

  7. John G. said on
    Reply

    Ublock should have more filters added by default! :]

  8. Pierre said on
    Reply

    That’s right, I have this update in Edge : ublock Origin from the Edge extensions store

  9. Tom Hawack said on
    Reply

    Waiting for updated uBlock Origin 1.4.8 to appear on AMO …

    One thing I don’t understand is this :

    When searching AMO for updated extensions with [https://addons.mozilla.org/en-US/firefox/search/?sort=updated&type=extension] ‘uBlock Origin’ is often displayed even when not updated : Mozilla loves uBO so do we …

    But when uBlock Origin has an available update, as now with ver. 1.4.8 [https://github.com/gorhill/uBlock/releases] AMO takes it time to deliver it… seems incoherent.

    It’s always possible to install latest uBO (or any other extension) from its its homepage (when available and with caution), I never do) or download it and install it manually from Firefox, but then the extension’s Release Notes don’t appear in the extension’s about:addons column…

    Not to mention that when Firefox itself is updated the release notes appear only later on.

    Said.

    1. upp said on
      Reply

      Mozilla takes the review process very very seriously, not like Chrome which uses 100% automated bot and that’s why there is full of malware extensions from Chrome Store, as recent Save cookies.txt extension infected a whole subreddit of yt-dlp and it was removed from Chrome Store, but it still managed to steal so many bank accounts of many users..

      1. Iron Heart said on
        Reply

        @upp

        Except only a tiny number of Firefox add-ons are manually reviewed, the rest gets an automatic review similar to the Chrome Web Store. Sorry to burst your bubble here.

    2. TelV said on
      Reply

      Agree with you Tom Hawack. Last UBO update was March 18 (v1.47.4) and no other update shows when running a check which I just did.

  10. John G. said on
    Reply

    Thanks @Ashwin for the article. :]

  11. upp said on
    Reply

    Good job, Chrome is so shady and Chromium-based also suffer he same issue if they don’t change the default behavior which likely.

    1. Iron Heart said on
      Reply

      @upp

      It’s not the first time I see you spreading BS about Chromium, but anyway: Extensions are inherently NOT a robust way of domain blocking. Neither uBlock Origin nor any other extension is. Built-in adblockers (like the one in Brave) directly interact with the network stack (without the roundabout way of extension APIs), there is no delay after the startup of the browser contrary to what would happen with uBO.

      It’s annoying that Firefox users don’t recognize uBO as the glorified bandaid that it is, as no adblocker ships with the browser. Same story with Chrome. But that doesn’t have to be true for all browsers just because it’s true with those two.

      1. upp said on
        Reply

        @Iron Heart: Stop speading BS, the reason why uBlock is less effective on Chrome because it was gutted, eventhen it’s still 10x better than any type of built-in adblock from those specific browsers that barely blocks anything, and don’t even allow users to config anything.

      2. Iron Heart said on
        Reply

        @upp

        > the reason why uBlock is less effective on Chrome because it was gutted

        It wasn’t gutted at all, Manifest V3 isn’t in effect yet. You know nothing.

        > eventhen it’s still 10x better than any type of built-in adblock from those specific browsers that barely blocks anything, and don’t even allow users to config anything.

        Oh yeah? I see zero ads with Brave, running it with roughly the same lists as uBO. How can it be 10 x better than that? What am I missing? Do you think the ad cares about which blocker blocks it? LMAO.

      3. upp said on
        Reply

        @Iron Heart: Stop your BS, it IS gutted even in MV2, MV3 makes it totally dogshit.

        When you need to block ads that the list doesn’t even contain, especially anti-adblock, anti-debugger… and shit then you have to care because you can’t just rely on other people to write filter for you, people can’t keep feeding your mouth forever lmao, but you’re NOT a power-user that’s why you accept such adblock with zero configuration, okay ?

      4. basingstoke said on
        Reply

        The world survived for 15+ years without any browsers having “built-in” ad block, but now it’s “not robust” and a “glorified bandaid”, dude, if it works, nobody cares.

      5. Iron Heart said on
        Reply

        @basingstoke

        The article describes that uBlock Origin actually doesn’t work for a time after the browser starts due to API performance constraints. That’s problematic especially if tabs with open websites are saved between sessions, which is the case for a lot of people. Then ads and tracking scripts may load upon restart, before uBlock Origin has started. That’s not robust, period.

        And yes, it is a glorified bandaid, it exists solely because some browsers don’t do adblocking ootb for business reasons.

      6. basingstoke said on
        Reply

        “some browsers don’t do adblocking ootb” .. yeah no it’s actually the other way around, most common browsers don’t do this – the ones that do are the exception. I’m willing to give you the point, that perhaps they somehow can function better when being built into a browser – but also my experience with browsers is typically: reboot PC, open browser – none of my previous tabs open up immediately (which would be a pretty odd behavior, actually, now that I think about it?), but instead I am given an option to restore my last session, or parts of it – so when I re-open my browser, it gets to “load up” by itself for at least a good few seconds, without any of my past tabs being loaded.

        So i hope you can see how some of your comments “seem” a little extreme, at least from my personal perspective. If it’s the case that ublock origin users must give their browser a few seconds before restoring their tabs (and they must turn off immediate/automatic tab-reopening), that seems like a much easier thing to do, than to integrate an adblocker into a browser.

    2. Deep Fried Shirt said on
      Reply

      Vivaldi, Opera and Brave are not implementing everything Chrome does. Also there is going to be this browser called Arc, currently in beta for Mac that is Chromium, bit has uBlock Origin built-in.

Leave a Reply

By commenting, you accept our privacy policy and keep the discussion respectful and on topic.