diff --git a/docs/source/installation/osx.rst b/docs/source/installation/osx.rst
index ad45548a..3849e48d 100644
--- a/docs/source/installation/osx.rst
+++ b/docs/source/installation/osx.rst
@@ -86,6 +86,13 @@ The colors look weird in iTerm2!
   contrast" slider in the color tab of  your OS X settings.
 * Please disable background transparency to resolve this issue.
 
+Statusline is getting wrapped to the next line in iTerm2
+--------------------------------------------------------
+
+* Turn off “Treat ambigious-width characters as double width” in `Preferences 
+  --> Text`.
+* Alternative: remove fancy dividers and other fancy symbols from configuration.
+
 I receive a ``NameError`` when trying to use Powerline with MacVim!
 -------------------------------------------------------------------
 
diff --git a/docs/source/installation/troubleshooting-common.rst b/docs/source/installation/troubleshooting-common.rst
index 80c95a3c..ef3da240 100644
--- a/docs/source/installation/troubleshooting-common.rst
+++ b/docs/source/installation/troubleshooting-common.rst
@@ -44,3 +44,9 @@ I get E858/E860 error in vim (Eval did not return a valid python object)
 
   and then use the stack trace to search for existing issues or to create a new 
   one.
+
+My vim statusline is not displayed completely and has too much spaces
+---------------------------------------------------------------------
+
+* Be sure you have ``ambiwidth`` option set to ``single``.
+* Alternative: remove fancy dividers and other fancy symbols from configuration.