DNS Filter Lists

Contribute

This project is built entirely from community pull requests. Adding or correcting a domain takes a few minutes.

Read Contribution Guide Open GitHub Repository

How to contribute

  1. Fork the repository on GitHub.
  2. Create a branch for your change.
  3. Add domains to the relevant src/<category>/domains.txt.
  4. Run npm run validate locally.
  5. Open a Pull Request.
  6. Automated checks run (syntax, duplicates, build).
  7. A maintainer reviews your change.
  8. Your PR is merged.
  9. Lists and the site rebuild and deploy automatically.

Submit a domain

Edit the source file for the category directly on GitHub, then open a pull request. The build system handles sorting, deduplication and chunking.

Add to Social Add to Suspicious Add to Advertising Add to Tracking Add to Malware Add to Phishing Add to Other

Rules

  • One domain per line, lowercase, no trailing dot.
  • No URLs, paths, ports, IP addresses or wildcards.
  • No duplicates within a category.
  • UTF-8, LF line endings, final newline.