diff --git a/docs/configuration.rst b/docs/configuration.rst
index 0dffa4a..57ad858 100644
--- a/docs/configuration.rst
+++ b/docs/configuration.rst
@@ -396,6 +396,8 @@ Some possible uses for these attributes are:
     provides additional formatting options for drawing rainbows and other
     fancy stuff.
 
+.. note:: Pango markup requires that i3bar is configured to use `Pango <http://i3wm.org/docs/userguide.html#fonts>`_, too. It can't work with X core fonts.
+
 Here is an example with the :py:mod:`.network` module.
 Pango markup is used to keep the ESSID green at all times while the
 recieved/sent part is changing color depending on the amount of traffic.