diff --git a/docs/guides/whitelist-blacklist.md b/docs/guides/whitelist-blacklist.md
new file mode 100644
index 0000000..3d9ac13
--- /dev/null
+++ b/docs/guides/whitelist-blacklist.md
@@ -0,0 +1,85 @@
+### What to Whitelist or Blacklist
+
+[This extension for Google Chrome](https://chrome.google.com/webstore/detail/whitelist-assistant-by-dn/fdmpekabnlekabjlimjkfmdjajnddgpc) can help you in finding out which domains you need to whitelist.
+
+
+### How to Whitelist or Blacklist
+
+There are scripts to aid users in adding or removing domains to the whitelist or blacklist.
+
+The scripts will first parse `whitelist.txt` or `blacklist.txt` for any changes, and if any additions or deletions are detected, it will reload `dnsmasq` so that they are effective immediately.
+
+Each script accepts the following parameters:
+
+
+
+
+ [domain] |
+ Fully qualified domain name you wish to add or remove. You can pass any number of domains. |
+
+
+ -d |
+ Removal mode. Domains will be removed from the list, rather than added |
+
+
+ -nr |
+ Update blacklist without refreshing dnsmasq |
+
+
+ -f |
+ Force delete cached blocklist content |
+
+
+ -q |
+ Quiet mode. Console output is minimal. Useful for calling from another script (see gravity.sh) |
+
+
+
+
+Domains passed are parsed by the script to ensure they are valid domains. If a domain is invalid it will be ignored.
+
+
+##### Example `pihole -w` usages
+
+
+
+
+ pihole -w domain1 [domain2...] |
+ Attempt to add one or more domains to the whitelist and reload dnsmasq. |
+
+
+ pihole -w -nr domain1 [domain2...] |
+ Attempt to add one or more domains to the whitelist, but do not reload dnsmasq. |
+
+
+ pihole -w -f domain1 [domain2...] |
+ Attempt to add one or more domains to the whitelist and force dnsmasq to reload |
+
+
+
+
+To remove domains from the whitelist:
+Add `-d` as an additional argument (e.g `pihole -w -d domain1 [domain2...]`)
+
+
+##### Example `pihole -b` usages
+
+
+
+
+ pihole -b domain1 [domain2...] |
+ Attempt to add one or more domains to the blacklist and reload dnsmasq. |
+
+
+ pihole -b -nr domain1 [domain2...] |
+ Attempt to add one or more domains to the blacklist, but do not reload dnsmasq. |
+
+
+ pihole -b -f domain1 [domain2...] |
+ Attempt to add one or more domains to the blacklist and force dnsmasq to reload |
+
+
+
+
+To remove domains from the blacklist:
+Add `-d` as an additional argument (e.g `pihole -b -d domain1 [domain2...]`)
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index b684295..6ff2dce 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -63,6 +63,7 @@ pages:
- 'Guides':
- 'Pi-hole as All-Around DNS Solution': guides/unbound.md
- 'Configuring DNS-Over-HTTPS on Pi-hole': guides/dns-over-https.md
+ - 'Editing Whitelist and Blacklist': guides/whitelist-blacklist.md
- 'Pi-hole and OpenVPN Server':
- 'Overview': 'guides/vpn/overview.md'
- 'Installation': 'guides/vpn/installation.md'