In this article

What is AdBlock?

Do I have to pay for AdBlock?

Is Adblock Plus an upgraded version of AdBlock?

What is the AdBlock for Safari app?

Should I install the AdBlock app or the AdBlock extension?

I just installed AdBlock. Why are there two AdBlock buttons in Safari and three AdBlocks in Safari Extensions Preferences?

Why can't I uninstall the AdBlock app like other extensions?

How do I uninstall the AdBlock for Safari app?

How do I disable AdBlock on a site that won't let me use an ad blocker?

I paused AdBlock or whitelisted the site. Why won't the site let me in?

How do I block ads again on a site I whitelisted?

What does the "Allow some non-intrusive ads" setting do?

I installed AdBlock. Why am I still seeing ads?

I think AdBlock is breaking a site I use. Can you fix it?

Why doesn't the AdBlock app have the same features as the extension?

Where are all the filter lists that were in the extension?

Can I whitelist my favorite YouTube channels?

How can I stop the AdBlock app window from opening when I start my computer?

How can I subscribe to additional filter lists?



What is AdBlock?

AdBlock is a content blocker for use with the Google Chrome, Mozilla Firefox, Apple Safari, and Microsoft Edge browsers. It works inside your browser to block unwanted content on the web, such as trackers (the magic behind those creepy ads that follow you around the web), and ads that slow page loading. And while it is not an antivirus or anti-malware application, AdBlock can help protect your computer from malicious software distributed through some types of ads.


Return to top


Do I have to pay for AdBlock?

AdBlock is free. We rely on donations from happy users to survive. If you would like to help out, you can donate on our website at https://getadblock.com/pay. And thanks!


Return to top


Is Adblock Plus an upgraded version of AdBlock?

AdBlock and Adblock Plus (ABP) are separate products made by different developers. (The reason the names are so similar is an interesting piece of Internet history.)


Return to top


What is the AdBlock for Safari app?

The AdBlock for Safari app, first released in 2018, is the "next-generation" version of the AdBlock for Safari extension that has been around since 2009. It replaces the AdBlock extension in MacOS Mojave/Safari 12 and later.


The AdBlock for Safari app consists of three components:

  1. The AdBlock extension, which uses filter lists to determine what to block on websites you visit. This is the content blocking piece, the part that actually blocks the ads. It has no user interface.

  2. The AdBlock Safari Icon extension, which allows you to control the AdBlock extension in Safari. You can use the AdBlock icon on the Safari toolbar to pause ad blocking everywhere, whitelist just the site you're on, open the app, find answers to questions, and contact AdBlock Support.

  3. The AdBlock app, which allows you to select and update filter lists and whitelist any site manually. The app's user interface includes the app window and a button in the MacOS menu bar.


Both extensions are required for the AdBlock app to work.


Return to top


Should I install the AdBlock app or the AdBlock extension?

For now, the choice is up to you. Apple will discontinue traditional Safari extensions in late 2018 and close the Safari Extensions Gallery sometime next year. Most people will still be able to use the AdBlock extension at least that long. Here are some considerations to keep in mind as you decide.


Did you install AdBlock from our website?

If you installed AdBlock from our website, not the Safari Extensions Gallery, it will stop working when you upgrade to Safari 12. That's because as of Safari 12, Apple no longer allows "self-hosted" extensions installed outside of the Safari Extensions Gallery.


Your choices are to refuse the MacOS Mojave/Safari 12 upgrade or install AdBlock from the Safari Extensions Gallery.


Did you install AdBlock from the Safari Extensions Gallery?

For now, you can keep using the AdBlock extension or switch to the new app, regardless of whether you upgrade to Safari 12 now or wait.


When the Safari Extensions Gallery is retired, your choices will depend on which version of Safari you're using:

  • If you have upgraded to Safari 12 by then, you will need to install the AdBlock app from the Mac App Store.

  • If you're still using Safari 10 or 11, you can either install the AdBlock app from the Mac App Store or install the self-hosted extension.

  • If you're still using Safari 9 or earlier, you will need to install the self-hosted extension.


Please see this article for instructions for installing the self-hosted AdBlock.


Do you need a feature that is not yet in the AdBlock app?

We are adding features to the app as quickly as we can. Some of the features in the extension may not be available right away. These include filter lists for languages other than English, the ability to subscribe to additional filter lists by URL, and YouTube channel whitelisting. If you rely on a feature that isn't in the app yet, you should continue to use the extension until the feature is added (keeping in mind the previous two considerations).


Return to top


I just installed AdBlock. Why are there two AdBlock buttons in Safari and three AdBlocks in Safari Extensions Preferences?

You probably had the AdBlock for Safari extension and installed the new AdBlock for Safari app. You should use either the app or the legacy extension, not both.


If you choose to use the app, disable "AdBlock 2.67.0 by BetaFish" in Safari Extensions Preferences. (The version number may be different from "2.67.0," but it should be higher than the AdBlock app version.)


If you choose to use the extension for now, disable "AdBlock Safari Icon 1.3.1 from AdBlock" and "AdBlock 1.3.1 from AdBlock" instead. (Again, the version number may be different, but it will be lower than the "AdBlock by BetaFish" extension version.)


How do I know which AdBlock to keep?

The app doesn't yet have all the features that are available in the extension. We'll be adding more features over the next few months. If a missing feature is important to you, we recommend you keep using the extension until the feature becomes available in the app.


Return to top


Why can't I uninstall the AdBlock app like other extensions?

The new version of AdBlock for Safari isn't a browser extension. It's a Mac app, which means it is uninstalled like any other Mac app. (See the next question.)


Return to top


How do I uninstall the AdBlock for Safari app?

If the app is running, you will need to close it first. You will also need to quit Safari to allow the extension part of the app to be uninstalled.

  1. If AdBlock is running, right-click the icon in the Dock and select Quit.

    Quitting Safari


  1. Open Safari if it isn't already. Open Safari Extensions preferences and disable both AdBlock and AdBlock Safari Icon.

    Disabling the AdBlock extensions in Safari Extensions preferences


  1. Quit Safari.


  1. Click the Launchpad icon in the Dock. Position the pointer over the AdBlock app icon, press and hold until all the icons begin to jiggle, and then click the little "x" and confirm.

    Confirming uninstalling the AdBlock app


Return to top


How do I disable AdBlock on a site that won't let me use an ad blocker?

The quickest way is to pause AdBlock, which suspends ad blocking everywhere. The content blocker remains active but idle, like a conscientious security guard at a cotton ball factory.


Click the AdBlock icon in the Safari toolbar and select Pause. The page reloads automatically.


When you're ready to start blocking ads again, click the AdBlock icon in the Safari toolbar and select Resume.


If you visit the site frequently and you don't mind the ads it serves, you can also whitelist it. If you don't want to see ads, you may have other options.


Return to top


I paused AdBlock or whitelisted the site. Why won't the site let me in?

If AdBlock is paused or you whitelisted the site and the site still tells you to disable your ad blocker, it means something other than AdBlock is preventing the site's ads from getting to your browser. Please see these troubleshooting tips.


Return to top


How do I block ads again on a site I whitelisted?

To remove the current site from your whitelist, click the AdBlock icon in the Safari toolbar and select Block ads on this site.


Return to top


What does the "Allow some non-intrusive ads" setting do?

The Allow some non-intrusive ads setting in the AdBlock app controls the Acceptable Ads filter list. Acceptable Ads does not block text ads in Google and Bing search results or other unobtrusive ads that don't bog down web page loading or get in the way of the content you came for. Acceptable Ads is a compromise between putting up with web pages filled with ads and depriving sites of the ad revenue that keeps them in business. Learn more about the Acceptable Ads program.


If you keep this setting on, ads that meet the Acceptable Ads criteria may appear on any website. Keep in mind that ads on sites you whitelist are independent of ads that are whitelisted by the Acceptable Ads filter list. If you whitelist a site, the ads you see may not meet Acceptable Ads criteria even if that setting is turned on.


Return to top


I installed AdBlock. Why am I still seeing ads?

These are the most common reason ads aren't blocked:

  • AdBlock is paused

  • The site is whitelisted

  • The non-intrusive ads setting is on

  • Your computer is infected with adware (malware designed to show you ads)

  • The site is using an aggressive ad technology that's difficult or impossible to circumvent (for example, Twitch.tv and many news sites)


Please try these troubleshooting suggestions.


Return to top


I think AdBlock is breaking a site I use. Can you fix it?

If the problem is caused by a bug in AdBlock, then we can fix it. If the problem is caused by an overzealous filter list blocking something it shouldn't, however, only the list authors can help. Please try these troubleshooting steps and suggestions.


Return to top


Why doesn't the AdBlock app have the same features as the extension?

We wanted to get the new app into the Mac App Store quickly. Some of our users are already upgrading to MacOS Mojave Beta and Safari 12, in which Apple is phasing out support for Safari extensions. We kept the feature set to the bare minimum in the initial release.


Never fear! We plan to add more of the familiar AdBlock features you love over the coming months.


Return to top


Where are all the filter lists that were in the extension?

In the interest of releasing a functional content blocker as quickly as possible (see the previous question), we included the minimum number of filter lists in version 1.0 of the app. We will be adding more filter lists as quickly as possible.


Return to top


Can I whitelist my favorite YouTube channels?

YouTube channel whitelisting is not available at this time.


Return to top


How can I stop the AdBlock app window from opening when I start my computer?

By default, the AdBlock for Safari app runs when you start your computer so that AdBlock can update your filter lists automatically. We plan to launch the app in the background (with no visible window) in a future release.


In the meantime, if you prefer not to see the AdBlock app window open every time you start your computer, you can turn that setting off. Click the AdBlock button in the MacOS menu bar and deselect Start AdBlock at Login.


Unselect "Start AdBlock at Login" on the AdBlock icon menu


Please note, you will need to manually fetch filter list updates by opening the AdBlock icon menu again and selecting Update Filter Lists.


Return to top


How can I subscribe to additional filter lists?

Right now, you can't. That's for two reasons.


First, the app uses Apple's Safari content blocking to block ads. (In this respect, it's the same as our iOS app and our legacy AdBlock for Safari desktop extension with the Safari Content Blocking option turned on.) Apple's content blocking mechanism doesn't understand the standard syntax that all filter lists are written in. Instead, it uses a special content blocking syntax. Before a filter list can be used with the AdBlock app, we have to convert it to the content blocking format. We've been able to convert EasyList and Acceptable Ads so far. We are working to convert more filter lists, but it's a slow process.


Second, Apple imposes a limit of 50,000 on the number of filter rules a content blocker can use at one time. (You can think of a content blocker as basically a thing that holds a list of filter rules and sends it to Safari.) 50,000 sounds like a large number. In practice, you can run up against that limit with just a few filter lists. EasyList, for example, has more than 40,000 rules all by itself. We could add more content blockers to the app, each with its own 50,000-rule limit. That adds significant complexity, however. Moreover, content blockers don't necessarily play well with each other, particularly when whitelisting rules are thrown into the mix.


I'm not a computer nerd. What does all that mean in plain language?

1. For now, the AdBlock app blocks ads on English-language websites only, and you are not able to subscribe to additional filter lists the way you can in the AdBlock extension.


2. If you regularly visit non-English sites or want to use more filter lists than are available in the app, you should consider using the AdBlock for Safari extension instead.


Return to top