diff --git a/library/src/visualize/image.rs b/library/src/visualize/image.rs
index 071aab214..c38f5e782 100644
--- a/library/src/visualize/image.rs
+++ b/library/src/visualize/image.rs
@@ -11,6 +11,10 @@ use crate::text::families;
 ///
 /// Supported formats are PNG, JPEG, GIF and SVG.
 ///
+/// _Note:_ Work on SVG export is ongoing and there might be visual inaccuracies
+/// in the resulting PDF. Make sure to double-check embedded SVG images. If you
+/// have an issue, also feel free to report it on [GitHub][gh-svg].
+///
 /// ## Example { #example }
 /// ```example
 /// #figure(
@@ -22,6 +26,8 @@ use crate::text::families;
 /// )
 /// ```
 ///
+/// [gh-svg]: https://github.com/typst/typst/issues?q=is%3Aopen+is%3Aissue+label%3Asvg
+///
 /// Display: Image
 /// Category: visualize
 #[element(Layout, LocalName, Figurable)]