diff --git a/CHANGELOG.md b/CHANGELOG.md
index c3e3182..1cb3841 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,7 @@ Features:
 
 Docs:
 * Documented the n-sided-ness of polygons and stars
+* svg: document rasterization on mask (#192)
 
 Special thanks to @lcarlsen
 
diff --git a/docs/dsl/svg.rst b/docs/dsl/svg.rst
index 085e692..dff487d 100644
--- a/docs/dsl/svg.rst
+++ b/docs/dsl/svg.rst
@@ -66,6 +66,11 @@ mask
 
   if specified, the image will be used as a mask for the given color/gradient. Transparent pixels are ignored, opaque pixels are the given color. Note: the origin for gradient coordinates is at the given x,y, not at 0,0 as it is most other places.
 
+.. warning::
+
+    For implementation reasons, your vector image will be rasterized when mask is applied. If you use this with, say, PDF, the images will be embedded as rasters, not vectors.
+
+
 crop_x
   default: ``0``