Setup

1. Open Settings
2. Go to Safari -> Extensions
3. Toggle AdZapper 
4. Click on the AdZapper Extension (below the content blocker)
5. Click the Toggle
6. Click on All Websites
7. Click on Allow
8. Quit and relaunch Safari 
9. Make sure the default list is enabled
10. Open doubleclick.net. AdZapper is setup if the page says ‘The URL was blocked by a content blocker’

Adding Filters to the Content Blocker

Jump to a section

• Adding Filters
• Blocking Domains
• Allowing Domains

Adding Filters

There are three ways to add filters

• Specify the filter url (ex: example.com/filter.txt)
• Import a local filter on your device
• Using the iOS Share Sheet on another app (like Files) to import a filter to AdZapper

Importing a local file:

1. Go to AdZapper and click on filters
2. Click on the import button
   • On iPad click the import button
   • On iPhone click Import Filters
3. Choose a filter from your device. Only text files are allowed
4. Click on the filter
5. Click on the enable toggle to enable your filter
6. Swipe down on the filter list (Like you are refreshing mail) to refresh the filter

Specifying a filter URL 

1. Go to AdZapper and click on Filters
2. Click on the add button
   • On iPad click the plus button
   • On iPhone click Add a Filter
3. Copy and paste (or type) the filter URL
4. Click Enable 
5. Swipe down on the filter list (Like you are refreshing mail) to refresh the filter

Using the iOS Share Sheet

1. While viewing a text file in Files (or another app of your choosing), press the share icon.
2. Scroll along the top row and select AdZapper
3. Enter a name for your new filter
4. Press Import
5. Open AdZapper to enable your new filter

If AdZapper doesn’t appear in the share menu

1. Go to the share menu
2. Scroll along the top row and select more
3. In the top right corner, select Edit
4. Toggle AdZapper
5. Press Done

For advanced users: 

You can edit filters with an external file editor. Go to Files -> On My iPad/iPhone (If you are using iCloud, then go to iCloud Drive)-> AdZapper -> Filters and click on the filter you want to edit.

Adding Blocked Domains

These domains are also blocked by AdZapper 

1. Click on Blocklist
2. Click the plus button (on iPhone click Add Domain)
3. Enter the domain you want to block (ex: to block google.com, type in google.com) 

For advanced users: 

See syntax notes on how to use CSS selectors on the blocklist

Adding Allowed Domains 

1. Click on Allowlist
2. Click on the plus button (on iPhone click Add Domain)
3. Enter the website domain that you want to disable AdZapper on.
4. Click Enable 

For advanced users: 

Toggling Invert Allow List will only block ads on the websites that are specified in the allowlist

Notes

• You MUST refresh AdZapper to see your changes take effect (Swipe down on the filter list [Like you are refreshing mail] to refresh the filter)
• See these notes on filter syntax

Syntax

Jump to a Section

• Overview
• Examples
• Targeting Resources
• Unblocking websites

AdZapper works with all filters following these rules:

• All comments start with a # or !
• Digits before a domain will be ignored (ex: ‘10.0.1.0 example.com’ will only include ‘example.com’) 
• CSS Selectors must come after the domain. They must be separated by a space (” “), or by ##. The domain will not be blocked; only the CSS selector will (ex: ‘example.com a’ will block all links on example.com)
• Javascript code must come after the domain and be seperated by #$# or #%#. The domain will not be blocked and Javascript will be injected on to that webpage. (ex: ‘example.com#$#console.log(`Hello World`)’ will log Hello World into the Safari Web Inspector console on example.com)
• Block a specific resource (like an image) by using $ before the resource and after the domain (ex: ‘example.com^$script will block all javascript on example.com). See later section for more details.
• The :has CSS pseudo-selector only works in Safari 16.5 or later

Multiple resources must be separated by a comma (“,”). Every resource must start with a dollar sign (“$”)

Unblocking websites

Use @@ before a rule to create an exception rule. For example, @@||example.com will unblock example.com from any previous rule (like ||example.com^$script).

This page will be updated as AdZapper supports new rules. For more information, check out the AdBlock Plus guide and the AdGuard guide on how to write filters.

Other Settings

AdZapper includes a few other settings:

• The ability to change the appearance of the app
• Enable a warning before deleting a filter
• Syncing data between devices via iCloud

Changing the appearance of the app

1. Go to the Settings App
2. Scroll down and select AdZapper
3. Click on Appearance and select your preferred appearance

Enabling a warning before deleting a filter

1. Go to the Settings App
2. Scroll down and select AdZapper
3. Toggle Warn before deleting filters
4. When you delete a filter, a message will appear confirming if you want to delete that filter

Syncing data via iCloud

If you have iCloud Drive setup, AdZapper should automatically sync. For more help, visit https://help.apple.com/icloud.

Enable/Disable iCloud Syncing

1. Quit AdZapper
2. Go to Settings
3. Click on [YOUR NAME]
4. Click on iCloud
5. Click Show All (iOS 16+)
6. Scroll down and toggle AdZapper

Disable Ad Blocking

AdZapper can be disabled to stop ad blocking.

1. Open Safari
2. Click on Extensions (in the toolbar)
3. Click on AdZapper
4. Click Disable AdZapper on All Websites