Pi-hole Optimized Blocklists
Pre-optimized, deduplicated blocklists for Pi-hole
[!NOTE]
New — nsfw_abp.txt, a subdomain-blocking NSFW list. An ABP-format version of nsfw.txt that blocks adult domains and all their subdomains (e.g. cdn.example.com as well as example.com) for more complete filtering. Requires Pi-hole Core ≥ 5.16 / FTL ≥ 5.22. See Available Lists.
Looking for more features? Check out Zach's Lists — a full-featured blocklist platform with custom source selection, smart whitelisting, and multiple output formats.
Available Lists
| List | Description | Domains |
|---|
| all_domains.txt | Everything combined (except NSFW) | 2,688,795 |
| advertising.txt | Ad networks & services | 271,119 |
| tracking.txt | Analytics & telemetry | 18,081 |
| malicious.txt | Malware, phishing, scams | 2,237,278 |
| suspicious.txt | Potentially unwanted | 52,446 |
| comprehensive.txt | Curated multi-category | 500,647 |
| nsfw.txt | Adult content (separate) | 530,875 |
| nsfw_abp.txt | Adult content — ABP format, blocks subdomains too | 498,830 |
Note: nsfw.txt is not included in all_domains.txt because it blocks legitimate adult sites. Add it separately if you want NSFW blocking. nsfw_abp.txt covers the same domains in ABP form (||domain^), so subdomains are blocked too. It leaves out subdomains that one of its rules already blocks, so it has fewer lines than nsfw.txt. Use it instead of nsfw.txt, not alongside it, for more thorough filtering (needs Pi-hole Core ≥ 5.16).
Last updated: October 25, 2026
Quick Start
- In the Pi-hole admin interface, open Lists (Pi-hole v6) or Group Management → Adlists (Pi-hole v5)
- Add the URL of each list you want from the table above
- Run
pihole -g, or use Tools → Update Gravity, to load them
The lists may include ABP-style entries (||domain^) that block a domain and all its subdomains. These require Pi-hole Core ≥ 5.16 / FTL ≥ 5.22 (released 2023; standard on current installs). Note that pihole -q won't enumerate the individual subdomains covered by an ABP entry.
Report a Domain
Found a domain that should be blocked or a false positive? Open an issue using one of the templates:
- Block Domain — request a malicious, ad, tracking, suspicious or adult domain to be blocked
- False Positive — report a legitimate domain that's being incorrectly blocked
- Bug Report — report a problem with the lists or automation
A bot posts an evidence report on each block and false-positive issue, and the maintainer makes every decision. An accepted change takes effect at the next weekly update.
FAQ
This repository provides static, pre-built blocklists updated weekly. Zach's Lists offers additional features:
- Custom source selection — pick which blocklists to include
- Smart whitelisting — regex, wildcards, subdomain patterns
- Multiple formats — hosts, plain, and Adblock syntax
- Real-time build progress
Both use the same underlying sources and are maintained by the same person.
Every Sunday, by a GitHub Actions build scheduled for 00:00 UTC. GitHub often starts scheduled builds a few hours late. Community-reported domains are included once their PR is merged before the next run.
- comprehensive.txt — Good balance for most users
- all_domains.txt — Maximum blocking (may cause false positives)
- Individual category lists — If you want granular control
Domains reported via issues are added to custom/<category>.txt files in the repo. These are referenced as sources in blocklists.conf via raw GitHub URLs, so the optimizer picks them up on the next weekly run just like any other upstream source.
Sources
The lists are built from these sources, configured in blocklists.conf. Each list keeps its own licence.
| Source | Lists used | Category | Licence |
|---|
| HaGeZi DNS Blocklists | Pro | comprehensive | GPL-3.0 |
| Threat Intelligence Feeds, Fake, DynDNS | malicious | |
| Pop-Up Ads | advertising | |
| Native trackers: Amazon, Apple, Huawei, LG webOS, OPPO/Realme, Roku, Samsung, TikTok, Vivo, Windows/Office, Xiaomi | tracking | |
| OISD | Big | comprehensive | GPL-3.0 |
| NSFW | nsfw | |
| 1Hosts | Lite | comprehensive | MPL-2.0 |
| AdAway | Hosts | advertising | CC BY 3.0 |
| Peter Lowe's list | Ad servers | advertising | Own licence, no commercial use |
| anudeepND | Ad servers | advertising | MIT |
Contributing
See CONTRIBUTING.md for details on how to report domains, submit PRs, and use the automated workflows.
Sponsors
Thanks to everyone who supports this project.
One-Time
Star History
Live chart, self-hosted (star-history.com's open-source backend) after GitHub restricted the stargazers API in mid-2026.
License
MIT License — see LICENCE for details.
