diff --git a/requirements/pip.txt b/requirements/pip.txt
index 941ac7abaa1..0fb48317964 100644
--- a/requirements/pip.txt
+++ b/requirements/pip.txt
@@ -6,7 +6,11 @@ docutils==0.14
 Sphinx==1.7.0
 sphinx_rtd_theme==0.2.5b1
 Pygments==2.2.0
-mkdocs==0.17.2
+
+# latest compatible version with our code
+# https://github.com/rtfd/readthedocs.org/pull/2916#discussion_r172991757
+mkdocs==0.15.0
+
 django==1.9.13
 six==1.11.0
 future==0.16.0