AdBlock for Safari is a fast and powerful ad blocking Mac app that speeds up web browsing by removing ads and reducing loading times of web pages. AdBlock starts blocking annoying ads on millions of websites from the moment you install it.
- Find AdBlock for Safari in the Mac App Store and click Get. (After the first time you install the app, you won't see the "Get" button again. If you are reinstalling, see Step 2.)
- Click Install.
- After the app is installed, click Open.
- Click Enable AdBlock in Safari.
- Select the checkboxes next to both AdBlock Engine and AdBlock Icon.
AdBlock is now set up to immediately block the majority of annoying ads on nearly every site you visit (regardless of whether the app is open).
Interacting with the AdBlock for Safari Mac app
- AdBlock menu icon - located on the top menu bar - which has app information (version information & debug data), the ability to manage filter lists and quick access to whitelisted sites in AdBlock’s Settings window. This only displays when the AdBlock app is open.
- AdBlock browser icon - located on the Safari toolbar - where AdBlock can be paused, sites or pages can be whitelisted (i.e. “Allow ads”), quick access to the AdBlock Settings window and a link to AdBlock Help.
- The AdBlock app icon - located in the Applications folder and/or on the Dock - this opens the AdBlock Settings window where AdBlock can be upgraded, filter lists can be managed and whitelisted sites (sites where ads are allowed to appear) can be added or removed.
Filter lists in the AdBlock for Safari Mac app
The Mac app uses Apple's Safari content blocking to block ads. In this respect, it's the same as our iOS app. Apple's content blocking mechanism doesn't understand the standard syntax that is used in standard filter lists. Instead, it uses a special content blocking syntax. Before a filter list can be used with the AdBlock app, it needs to be converted to the content blocking format. EasyList, Acceptable Ads, and Anti-Circumvention have all been converted.
You may find that AdBlock for Safari blocks fewer ads than AdBlock on Chrome, Firefox or Edge. This is because Apple imposes a 50,000 rule limit on the number of filter rules a content blocker can use at one time. While 50,000 sounds like a large number, in reality, it’s easy to run up against that limit with just a few filter lists. EasyList, for example, has more than 40,000 rules by itself. We could add more content blockers to the app, each with its own 50,000-rule limit but that adds significantly more complexity. Moreover, content blockers don't work well with each other, particularly when whitelisting rules are also being used.
There are three options for filter lists in the Mac app:
- Advanced ad blocking (i.e. Anti-circumvention filter list) -- available with the Gold upgrade
- Block annoying ads, pop-ups (i.e. EasyList filter list)
- Allow some non-intrusive ads (i.e. Acceptable Ads filter list)
To learn more about each filter list and how to subscribe to each, please see this article: Introduction to Filter Lists.
Manually updating AdBlock's filter lists
AdBlock's filter lists update themselves automatically when the app is open. Websites change their ads often, however, and it can be a day or so before the filter lists catch up.
If you start seeing ads that should be blocked, a good first step is to manually update, especially if you see that the last update was more than a day ago.
How to update filter lists in the AdBlock app via the Mac menu bar icon:
Click the AdBlock icon in the MacOS menu bar and select Update Filter Lists. This will open the app window and automatically check for any updates.
How to update filter lists in the AdBlock app via the app window:
Click the AdBlock icon on the Safari toolbar. Select Settings to open the AdBlock app window, select the Filter Lists tab and click on Update Filter Lists.
Click the AdBlock icon in the Dock or Applications folder to open the AdBlock app window, then select the Filter Lists tab and click on Update Filter Lists.
Seeing unblocked ads in the AdBlock for Safari Mac app?
There could be a number of reasons why ads are showing in the Mac app. First, please go to Safari > Preferences > Websites > Content Blockers and make sure the option “When visiting other websites” is set to On.
If that doesn’t help, for solutions to the most common reasons why ads appear, try the steps in this article: Seeing unblocked ads? Start here!
Managing AdBlock in the Dock
If an app is open on your Mac it will appear on the Dock. To keep an icon in the Dock, right-click (or Ctrl + click) on the icon in the Dock and go to Options > Keep in Dock.
To ensure the app icon does not appear on the Dock when closed, first make sure to uncheck System Preferences > Dock > Show recent applications in Dock. Unchecking this setting will prevent any closed apps from appearing on the Dock.
To remove an AdBlock icon that had previously been added to the Dock, right-click (or Ctrl + click) on the icon in the Dock and go to Options > Remove from Dock.
For additional tips, please see Apple’s article: Use the Dock on Mac.
Managing the AdBlock icon on the Safari toolbar
If the AdBlock icon does not appear on the Safari toolbar, go to Safari > Preferences > Extensions and make sure the option for the AdBlock Icon is selected.
If the AdBlock Icon is selected and still does not appear in the toolbar, in Safari go to View > Customize Toolbar… and drag the AdBlock icon to the toolbar.
Still having problems? Try a clean install.
Many issues can be addressed by completely wiping AdBlock from your Mac and performing a clean install.
We recommend using the free app, AppCleaner, however, if you already have a similar product installed, please feel free to use that instead.
Once AppCleaner is installed, to completely remove the AdBlock for Safari Mac app, do the following:
- Open the Applications folder.
- Drag the AdBlock icon into AppCleaner.
- Check ALL the boxes that appear then click Remove.
After AdBlock has been completely removed, restart your mac and try installing AdBlock for Safari again from the Mac App Store.
If you continue to have problems with the Mac app, please reach out to us at email@example.com.