How to use custom filters

If you are new to ad blocking or filter lists, we recommend starting with this article: Introduction to Filter Lists. Also, our blog post on how ad blockers work goes into greater detail if you're interested in what goes on behind the scenes.


How to create custom filters

  • Our manual ad blocking feature allows you to customize web pages and the resulting custom filters are added to your custom filters for you.
  • If you have a passing familiarity with coding, you can try writing your own custom filters. Adblock Plus created a really nice filter syntax tutorial and cheat-sheet: How to write filters and Adblock Plus filters explained.
  • Some pre-made custom filters can be found on the EasyList forums. This is where the list authors hang out, and where broken websites and unblocked ads are reported. You can search the EasyList forums for the domain name of a website and often find custom filters that have been suggested by the list authors and other volunteers. (The domain name is the main part of a website address. For example, in "serendipity.com," the domain is "serendipity.") If the suggested custom filters don't work, it won't help to report it to us. Instead, please report it as a comment on the forum post where you found them.

Where to find and edit your custom filters

Chrome, Firefox, and Edge
  1. Click the AdBlock icon on your browser’s toolbar, then the gear symbol on the dropdown menu.
  2. On the options menu, select the Customize tab.
  3. Click Edit to open the custom filters field.
  4. Paste the filter exactly as given in the field (or delete any unwanted filters) and click Save.
  5. Reload the webpage you are trying to change for the edit to take effect.

If adding a custom filter doesn't seem to work, you may need to clear your browser cache and cookies to clean up any old data that may be interfering.


Safari
Due to limitations imposed by Apple, custom filters are not available in the AdBlock for Safari Mac app.


Things to keep in mind when using filter lists

Custom filters enhance and override filter lists.

Filter lists block the vast majority of ads on web pages. What they can't block they can usually hide, with some exceptions. In some cases, the filters needed to block particularly stubborn ads also break some functionality on that site, and could even break completely unrelated websites. For this reason, the list authors are understandably reluctant to include such filters in their lists. Instead, they offer "custom" filters―filters you can use to enhance or override the filter lists. Custom filters affect only the people who choose to use them.


Custom filters can break websites.

List authors carefully test new filters before including them in their filter lists. It's impossible to test custom filters that thoroughly on every website. If your custom filters block too much, they can make websites unusable (but they can be removed).


Custom filters require maintenance.

Custom filters may stop working when a website’s design or layout changes or the website changes the way it serves ads to visitors. You will need to keep your custom filters up-to-date the way list authors do the filter lists.


Custom filters should be backed up.

If you have many custom filters, we recommend using the Premium Backup & Sync feature or keeping a copy in a text file as a backup is a good alternative. Likewise, you can turn your custom filters into your own personal filter list: How to create your own personal filter list.


Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.