diff --git a/doc/flatpak-run.xml b/doc/flatpak-run.xml
index d1d4b087..23503e11 100644
--- a/doc/flatpak-run.xml
+++ b/doc/flatpak-run.xml
@@ -49,6 +49,11 @@
             If <arg choice="plain">REF</arg> names a runtime, a shell is opened in the
             runtime. This is useful for development and testing.
         </para>
+        <para>
+            By default, flatpak will look for the application or runtime in all per-user
+            and system installations. This can be overridden with the <option>--user</option>,
+            <option>--system</option> and <option>--installation</option> options.
+        </para>
         <para>
             flatpak creates a sandboxed environment for the application to run in
             by mounting the right runtime at <filename>/usr</filename> and a writable
@@ -102,6 +107,34 @@
                 </para></listitem>
             </varlistentry>
 
+            <varlistentry>
+                <term><option>--user</option></term>
+
+                <listitem><para>
+                    Look for the application and runtime in per-user installations.
+                </para></listitem>
+            </varlistentry>
+
+            <varlistentry>
+                <term><option>--system</option></term>
+
+                <listitem><para>
+                    Look for the application and runtime in the default system-wide installations.
+                </para></listitem>
+            </varlistentry>
+
+            <varlistentry>
+                <term><option>--installation=NAME</option></term>
+
+                <listitem><para>
+                    Look for the application and runtime in the system-wide installation specified
+                    by <arg choice="plain">NAME</arg>
+                    among those defined in <filename>/etc/flatpak/installations.d/</filename>.
+                    Using <arg choice="plain">--installation=default</arg> is equivalent to using
+                    <arg choice="plain">--system</arg>.
+                </para></listitem>
+            </varlistentry>
+
             <varlistentry>
                 <term><option>-v</option></term>
                 <term><option>--verbose</option></term>