diff --git a/docs/authoring/lipsum.qmd b/docs/authoring/lipsum.qmd
index 5bb0ebc5f5..a2cfb7d703 100644
--- a/docs/authoring/lipsum.qmd
+++ b/docs/authoring/lipsum.qmd
@@ -30,3 +30,11 @@ Here's an example of `lipsum` generating two paragraphs of text, by adding `{{{<
 
 - `{{{< lipsum nparas >}}}`: `nparas` describes the number of paragraphs of placeholder text to include in the document. 
 - `{{{< lipsum start-end >}}}`: `start` and `end` are two numbers that describe the range of lorem ipsum paragraphs to include in the document.
+
+`lipsum` produces placeholder text in a predictable manner[^1]. This means that the same parameters will always yield identical text.
+However, you can choose to set `random=true` to generate a paragraph or a random collection of paragraphs.
+
+
+- `{{{< lipsum 1 random=true >}}}`: This will generate a single paragraph of random lorem ipsum text.
+
+[^1]: Since Quarto 1.7.14. Earlier versions of Quarto generate random text.