diff --git a/docs/index.rst b/docs/index.rst
index cd32a1f68..a40a5f624 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -17,6 +17,7 @@
 
     mitmproxy
     mitmdump
+    mitmweb
     config
 
 .. toctree::
diff --git a/docs/mitmweb.rst b/docs/mitmweb.rst
new file mode 100644
index 000000000..e761fdbcc
--- /dev/null
+++ b/docs/mitmweb.rst
@@ -0,0 +1,16 @@
+.. _mitmweb:
+.. program:: mitmweb
+
+mitmweb
+=======
+
+**mitmweb** is mitmproxy's web-based user interface that allows interactive examination and modification of HTTP traffic. Like mitmproxy, it differs from mitmdump in that all flows are kept in memory, which means that it's intended for taking and manipulating
+small-ish samples.
+
+.. warning::
+
+  Mitmweb is currently in beta. We consider it stable for all features currently exposed in the UI, but it still misses a lot of mitmproxy's features.
+
+
+.. image:: screenshots/mitmweb.png
+
diff --git a/docs/screenshots/mitmweb.png b/docs/screenshots/mitmweb.png
new file mode 100644
index 000000000..5f0cc9258
Binary files /dev/null and b/docs/screenshots/mitmweb.png differ