diff --git a/docs/formatstorage.html.in b/docs/formatstorage.html.in
index 6dbe0cab8e38ec61554dbb5186397df23a6c4846..14fa655d88183f0c319cda1c053df6640c3d207c 100644
--- a/docs/formatstorage.html.in
+++ b/docs/formatstorage.html.in
@@ -204,8 +204,8 @@
         This is mandatory when defining a volume.  <span class="since">Since 0.4.1</span></dd>
       <dt><code>key</code></dt>
       <dd>Providing an identifier for the volume which is globally unique.
-        This is optional when defining a volume, a key will be generated if
-        omitted. <span class="since">Since 0.4.1</span></dd>
+          This cannot be set when defining a pool: it is always generated.
+        <span class="since">Since 0.4.1</span></dd>
       <dt><code>allocation</code></dt>
       <dd>Providing the total storage allocation for the volume. This
         may be smaller than the logical capacity if the volume is sparsely