diff --git a/docs/plugins/Makefile.am b/docs/plugins/Makefile.am
index 0053e1e768..bfd4fd687c 100644
--- a/docs/plugins/Makefile.am
+++ b/docs/plugins/Makefile.am
@@ -90,7 +90,8 @@ EXTRA_HFILES = \
 	$(top_srcdir)/plugins/elements/gstqueue.h \
 	$(top_srcdir)/plugins/elements/gstqueue2.h \
 	$(top_srcdir)/plugins/elements/gsttypefindelement.h \
-	$(top_srcdir)/plugins/elements/gsttee.h
+	$(top_srcdir)/plugins/elements/gsttee.h \
+	$(top_srcdir)/plugins/elements/gstvalve.h
 
 # Images to copy into HTML directory.
 HTML_IMAGES =
diff --git a/docs/plugins/gstreamer-plugins-docs.sgml b/docs/plugins/gstreamer-plugins-docs.sgml
index a86fc82054..89a707c777 100644
--- a/docs/plugins/gstreamer-plugins-docs.sgml
+++ b/docs/plugins/gstreamer-plugins-docs.sgml
@@ -30,6 +30,7 @@
     <xi:include href="xml/element-queue2.xml" />
     <xi:include href="xml/element-tee.xml" />
     <xi:include href="xml/element-typefind.xml" />
+    <xi:include href="xml/element-valve.xml" />
   </chapter>
 
   <chapter>
diff --git a/docs/plugins/gstreamer-plugins-sections.txt b/docs/plugins/gstreamer-plugins-sections.txt
index 6f80cc5325..347921ac3b 100644
--- a/docs/plugins/gstreamer-plugins-sections.txt
+++ b/docs/plugins/gstreamer-plugins-sections.txt
@@ -71,6 +71,7 @@ GstFileSrc
 <SUBSECTION Standard>
 GstFileSrcClass
 GST_FILE_SRC
+GST_FILE_SRC_CAST
 GST_IS_FILE_SRC
 GST_TYPE_FILE_SRC
 GST_FILE_SRC_CLASS
@@ -155,6 +156,7 @@ GST_IS_QUEUE2_CLASS
 GST_TYPE_QUEUE2
 <SUBSECTION Private>
 GstQueue2Size
+GstQueue2Range
 gst_queue2_get_type
 </SECTION>
 
@@ -206,3 +208,18 @@ GST_IS_TEE_CLASS
 gst_tee_get_type
 </SECTION>
 
+<SECTION>
+<FILE>element-valve</FILE>
+<TITLE>valve</TITLE>
+GstValve
+<SUBSECTION Standard>
+GstValveClass
+GST_VALVE
+GST_IS_VALVE
+GST_TYPE_VALVE
+GST_VALVE_CLASS
+GST_IS_VALVE_CLASS
+<SUBSECTION Private>
+gst_valve_get_type
+</SECTION>
+
diff --git a/docs/plugins/gstreamer-plugins.args b/docs/plugins/gstreamer-plugins.args
index 3b0e6f1875..1338df57dc 100644
--- a/docs/plugins/gstreamer-plugins.args
+++ b/docs/plugins/gstreamer-plugins.args
@@ -894,7 +894,7 @@
 <RANGE>[0,100]</RANGE>
 <FLAGS>rw</FLAGS>
 <NICK>High percent</NICK>
-<BLURB>High threshold for buffering to finish.</BLURB>
+<BLURB>High threshold for buffering to finish. Only used if use-buffering is True.</BLURB>
 <DEFAULT>99</DEFAULT>
 </ARG>
 
@@ -904,7 +904,7 @@
 <RANGE>[0,100]</RANGE>
 <FLAGS>rw</FLAGS>
 <NICK>Low percent</NICK>
-<BLURB>Low threshold for buffering to start.</BLURB>
+<BLURB>Low threshold for buffering to start. Only used if use-buffering is True.</BLURB>
 <DEFAULT>10</DEFAULT>
 </ARG>
 
@@ -998,3 +998,13 @@
 <DEFAULT>0</DEFAULT>
 </ARG>
 
+<ARG>
+<NAME>GstValve::drop</NAME>
+<TYPE>gboolean</TYPE>
+<RANGE></RANGE>
+<FLAGS>rw</FLAGS>
+<NICK>Drop buffers and events</NICK>
+<BLURB>Whether to drop buffers and events or let them through.</BLURB>
+<DEFAULT>FALSE</DEFAULT>
+</ARG>
+
diff --git a/docs/plugins/gstreamer-plugins.hierarchy b/docs/plugins/gstreamer-plugins.hierarchy
index 6d424b5e9e..21c2ed7602 100644
--- a/docs/plugins/gstreamer-plugins.hierarchy
+++ b/docs/plugins/gstreamer-plugins.hierarchy
@@ -22,6 +22,7 @@ GObject
       GstQueue2
       GstTee
       GstTypeFindElement
+      GstValve
     GstIndex
       GstFileIndex
       GstMemIndex
diff --git a/docs/plugins/inspect/plugin-coreelements.xml b/docs/plugins/inspect/plugin-coreelements.xml
index 261a6ac1c7..9037730f86 100644
--- a/docs/plugins/inspect/plugin-coreelements.xml
+++ b/docs/plugins/inspect/plugin-coreelements.xml
@@ -246,5 +246,26 @@
         </caps>
       </pads>
     </element>
+    <element>
+      <name>valve</name>
+      <longname>Valve element</longname>
+      <class>Filter</class>
+      <description>Drops buffers and events or lets them through</description>
+      <author>Olivier Crete &lt;olivier.crete@collabora.co.uk&gt;</author>
+      <pads>
+        <caps>
+          <name>sink</name>
+          <direction>sink</direction>
+          <presence>always</presence>
+          <details>ANY</details>
+        </caps>
+        <caps>
+          <name>src</name>
+          <direction>source</direction>
+          <presence>always</presence>
+          <details>ANY</details>
+        </caps>
+      </pads>
+    </element>
   </elements>
 </plugin>
\ No newline at end of file