diff --git a/reference/v8.json b/reference/v8.json
index 31a4f482c0d..8658343c717 100644
--- a/reference/v8.json
+++ b/reference/v8.json
@@ -877,7 +877,7 @@
       "type": "string",
       "function": "piecewise-constant",
       "transition": true,
-      "doc": "Name of image in sprite to use for drawing image fills."
+      "doc": "Name of image in sprite to use for drawing image fills. For seamless patterns, image dimensions must be a factor of tile dimensions. Typically, tiles are 512px x 512px so image length and height should equal to 1, 2, 4, 8, 16, 32, 64, 128, 256, or 512."
     }
   },
   "paint_line": {
@@ -1289,7 +1289,7 @@
       "type": "string",
       "function": "piecewise-constant",
       "transition": true,
-      "doc": "Optionally an image which is drawn as the background."
+      "doc": "Optionally an image which is drawn as the background. For seamless patterns, image dimensions must be a factor of tile dimensions. Typically, tiles are 512px x 512px so image length and height should equal to 1, 2, 4, 8, 16, 32, 64, 128, 256, or 512."
     },
     "background-opacity": {
       "type": "number",