diff --git a/docs/sources/collection/xmldata.xml b/docs/sources/collection/xmldata.xml
index 0052b8ae..d7492df2 100644
--- a/docs/sources/collection/xmldata.xml
+++ b/docs/sources/collection/xmldata.xml
@@ -543,6 +543,48 @@
+
+ <variants/>
+
+
+ This tag lists variants of this
+ component. For example, the Modularity
+ effort of Fedora will provide multiple
+ 'streams' for a given component, where
+ each stream tracks a different major
+ version of an upstream project.
+
+
+ Variants conflict with each other: At
+ most one variant can be installed at any
+ one time.
+
+
+ This tag includes one or more
+ <variant/> tags. Each of these
+ children can have the same tags as the
+ <component/> tag, and provide a
+ replacement value. For example, if a
+ <variant/> has a
+ <description> tag, this should be
+ shown instead of the <description>
+ tag of the component.
+
+
+ A <variant/> must include a
+ <variantsummary>. This is a short
+ text that can be displayed in a menu
+ that allows selection of a variant.
+
+
+ If the <variants/> tag is present,
+ it should list all variants, including
+ the main variant described by the
+ <component/> tag.
+
+
+
+
<languages/>