diff --git a/src/guide/faq.mdx b/src/guide/faq.mdx
index 3ed493f..58f88f9 100644
--- a/src/guide/faq.mdx
+++ b/src/guide/faq.mdx
@@ -52,6 +52,14 @@ inside of them.
 }
 ```
 
+### Get rid of the purple/black icons
+The @@Quickshell.Quickshell.iconPath() function has three variants:
+- One draws a purple/black square if the icon is missing.
+- One allows you to specify a fallback icon if the desired one is missing.
+- One returns an empty string if the icon is missing.
+
+Either of the last two variants can be used to avoid the purple/black square.
+
 ## Something is broken
 
 ### There is a hole in my window