This repository hosts open-source, robust and vetted community whitelists for use with Pi-Hole V6.
To keep this list as up to date as possible, PRs and domain suggestions are welcome and will try and be quickly resolved. Please see below for info.
Want to report a new domain? Want to report an existing one? Feel free to file an issue.
This is a fork of the original anudeepND Whitelist.
It's aim is to support Pi-Hole V6 and be responsive to community requests.
It's aim is to support Pi-Hole V6 and be responsive to community requests.
- Features
- Whitelist Uses
- List Criteria
- Installation
- Overview
- How do I determine an ad domain?
- License
- All lists are curated and domains must have a robust explanation of why they are required, and why they break website functionality.
- No domains in 'whitelist.txt' may be used for Ad-blocking or tracking.
- New domains are added frequently.
- Lists can be easily imported as an 'allow list' with PiHole V6.
- Domains are categorized and are included in 3 different files (see below).
- If you are a beginner to Pi-Hole, adding these sites will solve issues with host files that block legitimate websites.
- Supported by Pi-Hole and Adguard Home
A community curated whitelist can be useful in situations where you run large blocklists above and beyond the standard lists. These may result in over-matching, and cause certain services (such as Google, Apple) to not work.
Furthermore, you may like to have a slightly more 'permissive' network and run either the optional or referral-sites list, such as if you have users on your network who might otherwise be frustrated by restrictive lists.
While this is being refined, this is the current criteria:
- The domain must break or reduce functionality of the website being visited.
- In the main whitelist, no ad-tracking or telemetry domains are allowed.
- The domain must have an age greater than 2 years.
- The impact of blacklisting the domain is sufficient to warrant whitelisting. Minor impacts will not be considered.
- There are no significant privacy, telemetry or ad-blocking impacts of whitelisting the domain.
- Open your Pi-Hole Instance
- Click on Lists
- Enter in the link to the correct Whitelist (see below) into the Address box
- Click 'Add Allowlist'
- Update Gravity
| File Name | Domain Count | Description | Update Frequency | Raw Link |
|---|---|---|---|---|
| whitelist.txt | 194 | This file contain domains that are safe to whitelist i.e. it does not contain any tracking or advertising sites. Adding this file fixes many problems like YouTube watch history, videos on news sites and so on. If you want to report additional domain feel free to file an issue. | Occasionally | link |
| referral-sites.txt | 77 | People who use services like Slickdeals and Fatwallet needs a few sites (most of them are either trackers or ads) to be whitelisted to work properly. This file contains some analytics and ad serving sites like doubleclick.net and others. If you don't know what these services are, stay away from this list. | Occasionally | link |
| optional-list.txt | 145 | This file contain domains that are needed to be whitelisted depending on the service you use. It may contain some tracking site but sometimes it's necessary to add bad domains to make a few services to work. | Occasionally | link |
- Using PiHole: Follow the official Pi-Hole instructions for identifying a problematic domain.
- Adam:ONE Assistant (formerly DNSthingy Assistant): This browser extension will list all of the domains that are queried when a web page is loaded. You can often look at the list of domains and cherry pick the ones that appear to be ad-serving domains.
- Using inbuilt Developer tool: For Chrome and Firefox,
ctrl+shift+Iwill land you in Developer tools menu. - Using an Android app:
Net Guardis an Android app that can be used to monitor any specific apps, works on unrooted devices too.
MIT License - This repository
Copyright (c) 2025 GoodnessJSON
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
MIT License - Original Fork
Original License - https://github.com/anudeepND/whitelist
Copyright (c) 2020 Anudeep ND <anudeep@protonmail.com>
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.