diff --git a/crates/typst-library/src/model/figure.rs b/crates/typst-library/src/model/figure.rs
index 5a137edbd..fef88a71f 100644
--- a/crates/typst-library/src/model/figure.rs
+++ b/crates/typst-library/src/model/figure.rs
@@ -132,6 +132,9 @@ pub struct FigureElem {
     ///   caption: [A glacier],
     ///   image("glacier.jpg", width: 60%),
     /// )
+    /// #show figure: set place(
+    ///   clearance: 1em,
+    /// )
     /// #lorem(60)
     /// ```
     pub placement: Option<Smart<VAlignment>>,