diff --git a/doc/xdg-app-builder.xml b/doc/xdg-app-builder.xml
index 09f48929..f11c1e2d 100644
--- a/doc/xdg-app-builder.xml
+++ b/doc/xdg-app-builder.xml
@@ -465,6 +465,22 @@
                     </varlistentry>
                 </variablelist>
             </refsect3>
+            <refsect3>
+                <title>Shell sources</title>
+                <para>
+                    This is a to create/modify the sources by running shell commands.
+                </para>
+                <variablelist>
+                    <varlistentry>
+                        <term><option>type</option></term>
+                        <listitem><para>"shell"</para></listitem>
+                    </varlistentry>
+                    <varlistentry>
+                        <term><option>commands</option></term>
+                        <listitem><para>An array of shell commands that will be run during source extraction</para></listitem>
+                    </varlistentry>
+                </variablelist>
+            </refsect3>
             <refsect3>
                 <title>Patch sources</title>
                 <variablelist>