White / Blacklist - Add "Reason" Field


We are using tool for our company. Its great, but occasionally we need to white or blacklist certain domains. Example:

if you try to stream foxnews video, it blocks a few domains used with part of the streaming (I assume ad-related requirements). We had to put a few white domains in there to permit that to work.

We got a phish email today to most users in our company, so in hopes to prevent users from doing anything with it, we pi-holed the domain as a precaution.

Putting the reason in might be nice for audit purposes. A year later, we may have no idea why its in there or not.


Add note to blacklist/whitelist sites
Whitelist: Differentiate "adlists sources" from user entries

Sounds reasonable. In the mean time, you can note the reasons in a separate company document if you’d like.



This might be out of scope, but I think it would be useful to have a notes text field that could be entered next to each domain in the whitelist & blacklist.

You could enter any information that proves useful to you to remember when or why a domain was added. For example, you could add the date it was added, a url or service it’s intended to fix or block, or the user or device that it was added for.

1 Like


Dupe of White / Blacklist - Add "Reason" Field?



It is. I’ll merge the two posts. Thanks.

1 Like

Centralized domain info DB/Tooltips on rationale for domain blocking

Just to give a little follow up since my post, for the time being I decided to keep a custom blacklist on github that my pihole subscribes to. That way when I add a new blocked domain, I can add notes to the entries.

For example…

baddomain.com # 06/27/2017 - malware

Of course this doesn’t fix the issue of whitelist & wildcard blacklist entries since there isn’t the ability to subscribe to those as lists, but it’s better than nothing.

1 Like


Being able to have categories of white/black listed items would be nice, especially if you toggle each category on/off easily. I’m currently looking into splitting my lists into a series of text files that periodically get fed to pihole by a script, e.g.:


The blacklists I can do by just putting them on GitHub, but AFAIK there’s no way to subscribe to a whitelist, and able to do it in the UI anyway would be a definite plus.



Being able to have categories of white/black listed items would be nice

This sounds very similar to the feature request Blocklist tagging and categorization to groups.



Can we expect this feature to be implemented at some point ?

I was kind of hoping to see it appear in version 4.0 :roll_eyes: :grimacing: :innocent:



Just a quick heads up for you guys: We’re still aware of this feature request and currently implementing a version of Pi-hole that uses an SQLite3 database for the blocking domains. It will support comments for entries as well as some other features like being able to temporarily disable entries without having to delete them. As this is very fundamental redesign, it will not come overnight, but you are invited to have a look at our idea if you like. It is still in a fairly basic state but already works while some things need to be improved.


Able to run user script in gravity.sh for Pi-hole Milestone 5