Skip to Content
Platform.Ontology

Ad blocker detection

Detects ad blockers via bait elements and filter-list selectors.

Gets silentlyDevice detailsBrowser stateWeb browsersWhen the page loadsWhile you use it

In one line

Can tell if you use an ad blocker and roughly which filter lists

Detects ad blockers via bait elements and filter-list selectors.

Reveals ad blocker use (about a third of desktop users) and which filter lists (EasyList, AdGuard, Fanboy, regional lists) are on. FingerprintJS probes about 20 lists; list pattern is itself identifying.

What it can and can't do

What the user does: Nothing. It happens when the page loads

It can

  • Test whether bait ads or ad scripts get blocked
  • Guess which filter lists you have turned on, such as EasyList or AdGuard
  • Show an ask to turn off your blocker
  • Use the pattern of blocked items as one clue to tell you apart from other visitors

It cannot

  • See which sites your blocker blocked elsewhere
  • Turn your blocker off
  • See your blocker settings directly; it only guesses from results
  • Be certain; privacy tools can hide the test

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported12008-12-11None
EdgeSupported122015-07-29None
FirefoxSupported12004-11-09None
SafariSupported12003-06-23None
Safari on iPhoneSupported12007-06-29None
Chrome on AndroidSupported182012-06-27None
Samsung InternetSupported1.02013-04-27None

How a site asks for it

APIHidden bait div with ad class names, fetch of ad script URL, selector tests
How access is grantednone
What the user seesNone
Needs a secure context (HTTPS)No
Needs a user gestureNo
How long it lastsread fresh on every page load; nothing stored
How to take it backnone needed (no grant)
Inside an iframeReadable from cross-origin iframes too (same values)

Typical flow

  1. Page script reads the value
  2. No prompt is shown

Data you get

Shape: object
How often: static per session

FieldTypeUnitRangePrecision
blocked selectors per listlistNoneabout 20 filter lists testedpresent or absent

Technical limits

  • Cannot see which sites were blocked on
  • DNS blockers invisible

The story

What it is

Checks whether you run an ad blocker, and sometimes which filter lists you use.

For you

You never see the check itself. What you may see is a pop-up that says Please turn off your ad blocker, or an article that stays blurred until you do. Some sites then show less or nothing.

For makers

Sites that live on ad income want to know how many readers block ads. They use the check to ask for an exception, serve a subscription offer or measure lost revenue. Fraud tools also use the exact blocker set as one more clue about a device.

Where you see it

TypeExampleApps
newsA news site blurs the article and asks you to disable your blocker or subscribe.Forbes, Business Insider
videoA video platform detects blockers and slows or interrupts playback until ads are allowed.YouTube
gamesA free browser games portal shows a polite wall asking you to whitelist the site because ads pay for the games.None named
adsAn ad recovery service injects a different, less intrusive ad format for people who block normal ads.Admiral
analyticsA publisher estimates how much revenue is lost to blockers in each country by counting detection hits.None named
securityA fingerprinting service adds the blocker and its list choices to a device profile that follows you across sites.FingerprintJS

Risks

  • Fingerprint clue about you
  • Pressure to turn off privacy tools

Good uses and abuse

Legitimate uses

  • Show whitelist notice

Known abuse

  • Fingerprint of filter list set

Scores

ScoreValueMeaning
Sensitivity3 of 5How revealing the data is
Utility4 of 5How useful it is to honest apps
Friction0 of 5How much the user has to do
Fingerprint bits1.5Rough identifying entropy, when known

History

  • 2016-06, paper: AmIUnique: ad blocker 0.99 bits

Sources

How well checked: Checked against real behavior.

On this page