last updated: Thu, 21 Nov 2024 11:03:43 GMT last validated: Fri, 15 Nov 2024 21:39:33 3538 ad server hostnames; 7749 IP addresses
PATREON: patreon.com/blocklist
main: [ about the list | how it works | four easy steps | latest news | submit hostnames | ways to use the list | lookup ]
tools: [ hosts file -> BIND converter | BIND zone file creator | miscellaneous scripts | software archive | links ]
more: [ main page | site news | list of formats | policy | RSS: updates, news | other bits and pieces | email ]
Block list reference guide
Quick reference guide to the formats available to view the block list list
NB

This is just a quick reference. Please see the main page and the news archive for full details. There's also a handy dandy form for choosing a format available on main page. And some other pages.

If you'd like a new format added, let me know. Most of the formats were suggested by other people - which also means that if things aren't exactly right it's probably not my fault; again, mail me me with corrections.

Also: possible values in <angle brackets> aren't real possible values - read the description to see what you actually use.
Index / Contents / Menu / Quickjump / Param & Format List / Whatsit
Block list formats: Query string parameters:
Optional query string parameters
field: append
append a string to the list entry
default value: don't append a string
possible value: pgl/ appends "/pgl" to the list entry
example: https://pgl.yoyo.org/adservers/serverlist.php?append=/pgl
field: device
changes the device name used for iptables and ipchains formats
default value: eth0 use eth0 in iptables and ipchains formats
possible value: eth2 use "eth2" as the device name
possible value: lo0 use "lo0" as the device name
example: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=iptables&device=eth2
field: direct
changes the DIRECT value for proxy auto config file format
default value: (empty) uses 'return "DIRECT"';
possible value: 127.0.0.1:8118 changes 'return "DIRECT";' to 'return "PROXY 127.0.0.1:8118";'
example: https://pgl.yoyo.org/adservers/serverlist.php?direct=127.0.0.1:8118
field: mimetype
allows the list of ad servers to be served as MIME types other than text/html
default value: html delivers ad server list as text/html
possible value: plaintext delivers ad server list as if it were a .txt file
example: https://pgl.yoyo.org/adservers/serverlist.php?mimetype=plaintext
field: notrackers
don't show entries which are flagged as trakcers
default value: 0 don't hide trackers
possible value: 0 don't hide trackers
possible value: 1 hide trackers
example: https://pgl.yoyo.org/adservers/serverlist.php?notrackers=1
field: onlytrackers
only show entries which are flagged as trakcers
default value: 0 only show trackers
possible value: 0 don't restrict to only trackers
possible value: 1 only show trackers
example: https://pgl.yoyo.org/adservers/serverlist.php?onlytrackers=1
field: prepend
prepend a string to the list entry
default value: don't prepend a string
possible value: pgl/ prepends "pgl/" to the list entry
example: https://pgl.yoyo.org/adservers/serverlist.php?prepend=pgl/
field: showintro
sets whether a short intro to the list is displayed at the top to explain what the person is looking at (automatically set to false for some of the formats where text at the top of the page would break things)
default value: 1 displays the introduction
possible value: 0 hides the introduction
example: https://pgl.yoyo.org/adservers/serverlist.php?showintro=0
field: skip
skip hostnames
default value: (empty) don't skip any servers
possible value: hostname any ad server hostname you want to skip when viewing the list
example: https://pgl.yoyo.org/adservers/serverlist.php?skip=101com.com,207.net
field: startdate
(NB: PHP array) specifies the date from which to view additions or updates to the list of ad servers; day, month, and year can be set with the current date's day, month, or year being used if unspecied
default value: <today> startday=21&startmonth=11&startyear=2024
possible value: <tomorrow> startday=22&startmonth=11&startyear=2024
example: https://pgl.yoyo.org/adservers/serverlist.php?startday=1&startmonth=4&startyear=2003
field: useip
sets the IP address used when viewing the list as a HOSTS file or any other format using a specific IP address
default value: 127.0.0.1 the localhost IP address, used by most HOSTS files
possible value: 10.0.0.1 private but valid IP address
possible value: 192.168.0.0.1 another private but valid IP address
possible value: 198.41.0.4 valid IP address (for a.root-servers.net)
possible value: 0.0.0.1 invalid IP address; shortens the length of the list and solves some problems caused by browsers who throw errors after failing to contact localhost; however, also causes problems with other applications who try to resolve the IP and fail
example: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=hosts;useip=192.168.0.1
field: validity
controls whether invalid entries are listed
default value: 0 only list entries marked as valid
possible value: 1 list both valid and invalid entries
possible value: 2 only list invalid entries
example: https://pgl.yoyo.org/adservers/serverlist.php?validity=1
field: zonefilename
sets the filename of the zone file referenced when viewing the list as a bind config file
default value: null.zone.file same as the example null zone file supplied
possible value: example.zone.file empty zone file giving an alternate IP address for hostname lookups
example: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=bindconfig;zonefilename=db.your.empty.zone
Available formats for viewing the blocklist of hostnames and domains
To view the blocklist of hostnames and domains in a particular format, just go to:
https://pgl.yoyo.org/adservers/serverlist.php?hostformat=someformat
where someformat is the format you want to view the list in. Available are listed below:
adblock - for use with adblock
description: starting point for the AdBlock plugin for Mozilla
more info: https://pgl.yoyo.org/adservers/news.php#adblock
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=adblock
adblockplus - AdBlock Plus format
description: for use with AdBlock Plus
more info: https://adblockplus.org/en/subscriptions
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=adblockplus
bindconfig - bind 8 config file format
description: sets a bind nameserver to be the master NS for all ad server zones if included in the config; can be used with the "include" directive
more info: https://pgl.yoyo.org/adservers/hosts2bind.php
notes: my personal method of using the list of ad servers because it's easy to set up, easy to block whole zones (eg, all hostnames under doubleclick.net instead of each individual one), and on a local network it's incredibly easy to set up a new machine to start blocking ads - just change the nameserver
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=bindconfig
cookperm - http permission file format [deprecated]
description: able to be used with Mozilla as a list of servers from which to block images
more info: http://www.deftone.com/blogzilla/archives/ad_blocking.html
notes: deprecated by the hostperm.1 format
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=cookperm
dnsmasq - dnsmasq format
description: able to be used in a dnsmasq configuration
more info: https://pgl.yoyo.org/adservers/news.php#dnsmasq
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=dnsmasq
dnsmasq-server - dnsmasq format, using "server"
description: able to be used in a dnsmasq configuration
more info: https://www.reddit.com/r/openwrt/comments/3l7iy8/dnsbased_ad_blocking/cxj9k0q?context=3
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=dnsmasq-server
glimmerblocker.xml - Glimmerblocker format
description: for use with the Mac ad-blocker, Glimmerblocker
more info: https://pgl.yoyo.org/adservers/news.php#glimmerblocker
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=glimmerblocker.xml
hostperm.1 - http permission file format
description: able to be used with Mozilla as a list of servers from which to block images
more info: https://pgl.yoyo.org/adservers/news.php#hostperm.1
notes: supersedes the cookperm format
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=hostperm.1
hosts - hosts file format
description: one of the most common ways of blocking ads with a list of ad servers, very easy to implement but not the most efficient or effective; however, a good way to start (see the main page for a quick guide to using the list in this way)
more info: https://pgl.yoyo.org/adservers/news.php#foursteps
notes: apple macs must use the "machosts" format; see section above for ways to modify how the list is displayed
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=hosts
ie8-private-xml - IE8 InPrivate Browsing XML format
description: for use with Internet Explorer 8's InPrivate Browsing
more info: https://pgl.yoyo.org/adservers/news.php#ie8-xml-private-added
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=ie8-private-xml
junkbuster - in internet junkbuster/privoxy format
description: can be used as a starting point for the Internet Junkbuster Proxy, also usable with Privoxy
more info: https://pgl.yoyo.org/adservers/news.php#fourmore
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=junkbuster
littlesnitch - Little Snitch format
description: for use with Little Snitch
more info: https://forums.obdev.at/viewtopic.php?f=1&t=10200&p=30658&hilit=yoyo#p30658
notes: see URL for details on how to import (thanks to Nick Ashton-Hart for the pointer)
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=littlesnitch
littlesnitch-rule-group-subscriptions - Little Snitch with Rule Group Subscriptions
description: for use with Little Snitch's Rule Group Subscriptions feature
more info: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=littlesnitch-rule-group-subscriptions
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=littlesnitch-rule-group-subscriptions
machosts - mac hosts file format
description: see description for the "hosts" format - only difference is that this format can be used on apple macs
more info: https://pgl.yoyo.org/adservers/news.php#macinfo
notes: incompatible with any other hosts file format
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=machosts
ms-isa-server-2004-xml - XML format for use with MS ISA Server 2004
description: able to be used with Microsoft Internet Security & Acceleration Server 2004
more info: https://pgl.yoyo.org/adservers/news.php?#msisaserverxml
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=ms-isa-server-2004-xml
ms-isa-server-2006-xml - XML format for use with MS ISA Server 2006
description: able to be used with Microsoft Internet Security & Acceleration Server 2006
more info: https://pgl.yoyo.org/adservers/news.php?#isa-server-2006-xml
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=ms-isa-server-2006-xml
msfilter - IE9 Tracking Protection format
description: for use with IE9's tracking protection lists
more info: https://pgl.yoyo.org/adservers/news.php#msfilter
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=msfilter
msie-nocookies-xml - an IE XML reject file
description: for use with IE 6 - under Tools -> Options -> Privacy -> Import
more info: https://pgl.yoyo.org/adservers/news.php#iexml
notes: only blocks cookies, not ads
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=msie-nocookies-xml
neatgear - a netgear block list
description: for use with the Netgear FM114P
more info: https://pgl.yoyo.org/adservers/news.php#webclean-netgear
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=neatgear
one-line - all hostnames on one line
description: just a list of all entries in the list on the same line
more info: https://pgl.yoyo.org/adservers/news.php#oneline
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=one-line
operafilter - in opera url filter ini file format
description: suitable for use with Opera's URL filtering feature
more info: https://pgl.yoyo.org/adservers/news.php#operafilter
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=operafilter
pdnsd - pdnsd format
description: able to be used with pdnsd
more info: https://pgl.yoyo.org/adservers/news.php#pdnsd
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=pdnsd
pgl-xml - in pgl-xml format (ie, an ad-hoc XML format I made up)
description: ad-hoc XML version of the list suggested to make it easy to use XSL to manipulate the format
more info: https://pgl.yoyo.org/adservers/news.php#pgl-xml
notes: totally made up; added by request; no idea if it's actually useful
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=pgl-xml
plain - plain list of hostnames
description: one hostname per line
more info: https://pgl.yoyo.org/adservers/news.php#plaintext
notes: see also "all on one line" and options above for MIME types etc
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=plain
proxyautoconfig - browser proxy autoconfig (PAC) file
description: can be used to automatically configure your browser to ignore images located on servers appearing in the list of ad servers; the list can be copied in this format to a local location (faster, but needs updating) or you can set your browser to load it from pgl.yoyo.org every time you start (slower, always up to date)
more info: https://pgl.yoyo.org/adservers/news.php#proxypac
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=proxyautoconfig
rpz - RPZ format
description: for use with BIND as an RPZ (Response Policy Zones) file
more info: https://www.isc.org/docs/BIND_RPZ.pdf
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=rpz
squid-dstdom-regex - a squid dstdom_regex block file
description: can be included as part of a squid proxy configuration file to make squid reject requests to servers on the list of ad servers
more info: https://pgl.yoyo.org/adservers/news.php#squidupdate
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=squid-dstdom-regex
unbound - Unbound DNS server config
description: for use with the Unbound DNS server
more info: https://pgl.yoyo.org/adservers/news.php#unbound
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=unbound
webclean - a webclean pattern file
description: usable with Webclean, a local proxy that allows configurable filtering of HTTP requests
more info: https://pgl.yoyo.org/adservers/news.php#webclean-netgear
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=webclean
webwasher - a webwasher URL filter list
description: usable as an example of the webwasher format or as a starting point
more info: https://pgl.yoyo.org/adservers/news.php#webwasher
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=webwasher
win32reg-sp - as a win32 registry file (post-service pack)
description: able to imported to the registry to make the Microsoft DNS service use a null zone file for all ad servers
more info: https://pgl.yoyo.org/adservers/news.php#win32registryupdate
notes: only usable after installing the service pack
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=win32reg-sp
win32reg-sp4 - as a win32 registry file (for Win2K servers post-SP4)
description: able to imported to the registry to make the Microsoft DNS service use a null zone file for all ad servers
more info: https://pgl.yoyo.org/adservers/news.php#win32regpostpatch
notes: apparently Win2K servers after SP4 have another slightly registry different format
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=win32reg-sp4
win32registry - a win32 registry file (pre-service pack)
description: able to imported to the registry to make the Microsoft DNS service use a null zone file for all ad servers
more info: https://pgl.yoyo.org/adservers/news.php#win32registry
notes: doesn't work after installing the service pack
view: https://pgl.yoyo.org/adservers/serverlist.php?hostformat=win32registry