From b03aaf173bb8c7ee50df9f7164c56d1c809e242b Mon Sep 17 00:00:00 2001
From: KAGEYAM4 <75798544+KAGEYAM4@users.noreply.github.com>
Date: Wed, 11 Sep 2024 01:47:41 +0530
Subject: [PATCH] docs: add notes regarding behaviour of the blacklist (#3260)

---
 docs/docs/search.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/docs/search.md b/docs/docs/search.md
index 1e3271ba..05de06cb 100644
--- a/docs/docs/search.md
+++ b/docs/docs/search.md
@@ -52,6 +52,12 @@ You can blacklist some tags or combinations of tags to not see them in the resul
 
 It can be edited in the settings in the "Save > Blacklist" category, or tags can be added to the blacklist by right-clicking on them and selecting "Blacklist".
 
+Note:
+
+* Blacklist is a post-filter: it is applied after results are returned from the sources.
+* When using the CLI, images that contains blacklisted tags will no be downloaded unless the `--blacklist` option is used.
+* When using the GUI, images that contain blacklisted tags will not be downloaded unless explicitly selecting them and clicking 'save'.
+
 ### Syntax
 Each line of the blacklist corresponds to a combination of tags and uses the same syntax as post-filters.