diff --git a/docs/content/en/docs/Concepts/Overview/usage.md b/docs/content/en/docs/Concepts/Overview/usage.md
index c3f1dc7a..b2bb6dd5 100644
--- a/docs/content/en/docs/Concepts/Overview/usage.md
+++ b/docs/content/en/docs/Concepts/Overview/usage.md
@@ -102,6 +102,24 @@ Note: the regex argument is optional
 $ luet search --file <file_pattern>
 ```
 
+## Show package files
+
+Files are displayed when visualizing output of search in json or in yaml, for instance, consider the following example:
+
+```bash
+$ luet search -o yaml system/luet-0.32.5
+packages:                                                                                           
+- category: system
+  files:
+  - usr/bin/luet
+  hidden: false
+  installed: true
+  name: luet
+  repository: luet
+  target: ""
+  version: 0.32.5
+```
+
 ### Search output
 
 Search can return results in the terminal in different ways: as terminal output, as json or as yaml.
@@ -135,4 +153,4 @@ $ luet search --table <regex>
 
 Luet output is verbose by default and colourful, however will try to adapt to the terminal, based on which environment is executed (as a service, in the terminal, etc.)
 
-You can quiet `luet` output with  the `--quiet` flag or `-q` to have a more compact output in all the commands.
\ No newline at end of file
+You can quiet `luet` output with  the `--quiet` flag or `-q` to have a more compact output in all the commands.