diff --git a/master/docs/developer/config.rst b/master/docs/developer/config.rst
index 9eb1ceb8e4c..307e931d693 100644
--- a/master/docs/developer/config.rst
+++ b/master/docs/developer/config.rst
@@ -250,6 +250,10 @@ Builder Configuration
 
         The builder's mergeRequests callable.
 
+    .. py:attribute:: description
+
+        The builder's description, displayed in the web status.
+
 Error Handling
 ==============
 
diff --git a/master/docs/manual/cfg-builders.rst b/master/docs/manual/cfg-builders.rst
index b32511f9f90..d680f00581a 100644
--- a/master/docs/manual/cfg-builders.rst
+++ b/master/docs/manual/cfg-builders.rst
@@ -122,6 +122,10 @@ Other optional keys may be set on each ``BuilderConfig``:
     specific for this builder in this parameter. Those values can be used
     later on like other properties. :ref:`Interpolate`.
 
+``description``
+    A builder may be given an arbitrary description, which will show up in the
+    web status on the builder's page.
+
 .. index:: Builds; merging
 
 .. _Merging-Build-Requests: