diff --git a/source/chapters/library.rst b/source/chapters/library.rst
index a513abacf..2d7773001 100644
--- a/source/chapters/library.rst
+++ b/source/chapters/library.rst
@@ -396,7 +396,7 @@ to limit certain search terms to particular properties of your tracks. Also cons
 Mixxx supports the following filters:
 
 * **Text filtering**: album_artist, album, artist, comment, composer, crate,
-  genre, grouping, location, title
+  genre, grouping, location, title, directory
 
   Examples
     ::
@@ -426,6 +426,24 @@ Mixxx supports the following filters:
       title:= "Track 1"
       artist:="DJ Flop"
 
+  Even though all text filters behave the same, it's worth mentioning the some subtleties with the
+  'location' and 'directory' filter:
+
+  * find tracks only in "My Music\Disco", ignore subdirectories
+    ::
+
+      dir:="D:\My Music\Disco"
+
+  * find tracks in "My Music\Disco" and all subdirectories,
+    ::
+
+      dir:"D:\My Music\Disco"
+
+  * find tracks only in subdirectories of "Disco" (note trailing '\\')
+    ::
+
+      dir:"D:\My Music\Disco\"
+
 * **Numeric filtering**: bpm, bitrate, played, rating, track, year, id (internal track id)
 
   Examples
@@ -560,6 +578,8 @@ cm  comment
 --- ------------------
 cp  composer
 --- ------------------
+dir directory
+--- ------------------
 du  duration
 --- ------------------
 g   genre