Ad blocker detection
Detects ad blockers via bait elements and filter-list selectors.
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
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 1 | 2008-12-11 | None |
| Edge | Supported | 12 | 2015-07-29 | None |
| Firefox | Supported | 1 | 2004-11-09 | None |
| Safari | Supported | 1 | 2003-06-23 | None |
| Safari on iPhone | Supported | 1 | 2007-06-29 | None |
| Chrome on Android | Supported | 18 | 2012-06-27 | None |
| Samsung Internet | Supported | 1.0 | 2013-04-27 | None |
How a site asks for it
| API | Hidden bait div with ad class names, fetch of ad script URL, selector tests |
| How access is granted | none |
| What the user sees | None |
| Needs a secure context (HTTPS) | No |
| Needs a user gesture | No |
| How long it lasts | read fresh on every page load; nothing stored |
| How to take it back | none needed (no grant) |
| Inside an iframe | Readable from cross-origin iframes too (same values) |
Typical flow
- Page script reads the value
- No prompt is shown
Data you get
Shape: object
How often: static per session
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
blocked selectors per list | list | None | about 20 filter lists tested | present 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
| Type | Example | Apps |
|---|---|---|
| news | A news site blurs the article and asks you to disable your blocker or subscribe. | Forbes, Business Insider |
| video | A video platform detects blockers and slows or interrupts playback until ads are allowed. | YouTube |
| games | A free browser games portal shows a polite wall asking you to whitelist the site because ads pay for the games. | None named |
| ads | An ad recovery service injects a different, less intrusive ad format for people who block normal ads. | Admiral |
| analytics | A publisher estimates how much revenue is lost to blockers in each country by counting detection hits. | None named |
| security | A 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
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 3 of 5 | How revealing the data is |
| Utility | 4 of 5 | How useful it is to honest apps |
| Friction | 0 of 5 | How much the user has to do |
| Fingerprint bits | 1.5 | Rough identifying entropy, when known |
History
- 2016-06, paper: AmIUnique: ad blocker 0.99 bits
Related capabilities
Related
- Extension presence probing. Can find out which Chrome extensions you have by testing known files
Sources
- fingerprintjs source: dom_blockers
- AmIUnique: Beauty and the Beast, Laperdrix et al. 2016 (attribute entropy)
How well checked: Checked against real behavior.