diff --git a/docs/sources/collection/xmldata.xml b/docs/sources/collection/xmldata.xml
index 0052b8aeb..720baa50e 100644
--- a/docs/sources/collection/xmldata.xml
+++ b/docs/sources/collection/xmldata.xml
@@ -283,8 +283,8 @@
 						This icon type may have <literal>width</literal> and <literal>height</literal> properties.
 					</para>
 					<para>
-						<literal>remote</literal> icons loaded from a remote URL. Currently, at least HTTP urls must be supported.
-						This icon type may have <literal>width</literal> and <literal>height</literal> properties.
+						<literal>remote</literal> icons loaded from a remote URL. Currently, only HTTP urls are supported.
+						This icon type should have <literal>width</literal> and <literal>height</literal> properties.
 					</para>
 					<para>
 						Examples of the different methods to specify an icon:
diff --git a/docs/sources/metainfo/component.xml b/docs/sources/metainfo/component.xml
index b8d958a6c..157ebb97c 100644
--- a/docs/sources/metainfo/component.xml
+++ b/docs/sources/metainfo/component.xml
@@ -143,6 +143,30 @@
 		</listitem>
 		</varlistentry>
 
+		<varlistentry id="tag-icon">
+		<term>&lt;icon/&gt;</term>
+		<listitem>
+			<para>
+				The <code>&lt;icon/&gt;</code> tag describes the component icon. It is mostly used for GUI applications (component-type <literal>desktop-application</literal>).
+				It can be of the type <literal>stock</literal>, <literal>local</literal>,
+				or <literal>url</literal>.
+			</para>
+			<para>
+				<literal>stock</literal> icons are loaded from stock. The icon name should never include any file-extension or path.
+			</para>
+			<para>
+				<literal>local</literal> icons are loaded from a file in the filesystem.
+				They should specify a full file path.
+				This icon type may have <literal>width</literal> and <literal>height</literal>
+                                properties.
+			</para>
+			<para>
+				<literal>remote</literal> icons loaded from a remote URL. Currently, only HTTP urls are supported.
+				This icon type should have <literal>width</literal> and <literal>height</literal> properties.
+			</para>
+		</listitem>
+		</varlistentry>
+
 		<varlistentry id="tag-description">
 		<term>&lt;description/&gt;</term>
 		<listitem>