diff --git a/docs/img/src/fill-pattern.png b/docs/img/src/fill-pattern.png
new file mode 100644
index 00000000000..a4a2cb0b812
Binary files /dev/null and b/docs/img/src/fill-pattern.png differ
diff --git a/docs/pages/example/fill-pattern.html b/docs/pages/example/fill-pattern.html
new file mode 100644
index 00000000000..fa6bf2084cc
--- /dev/null
+++ b/docs/pages/example/fill-pattern.html
@@ -0,0 +1,49 @@
+<div id='map'></div>
+
+<script>
+var map = new mapboxgl.Map({
+    container: 'map',
+    style: 'mapbox://styles/mapbox/streets-v9',
+    zoom: 1
+});
+
+map.on('load', function() {
+    // Add GeoJSON data
+    map.addSource('source', {
+        "type": "geojson",
+        "data": {
+            "type": "Feature",
+            "properties": {},
+            "geometry": {
+                "type": "Polygon",
+                "coordinates": [[
+                    [-30, -25],
+                    [-30, 35],
+                    [30, 35],
+                    [30, -25],
+                    [-30, -25]
+                ]]
+            }
+        }
+    });
+
+    // Load an image to use as the pattern
+    map.loadImage('https://upload.wikimedia.org/wikipedia/commons/thumb/6/60/Cat_silhouette.svg/64px-Cat_silhouette.svg.png', function(err, image) {
+        // Throw an error if something went wrong
+        if (err) throw err;
+
+        // Declare the image
+        map.addImage('pattern', image);
+
+        // Use it
+        map.addLayer({
+            "id": "pattern-layer",
+            "type": "fill",
+            "source": "source",
+            "paint": {
+                "fill-pattern": "pattern"
+            }
+        });
+    });
+});
+</script>
diff --git a/docs/pages/example/fill-pattern.js b/docs/pages/example/fill-pattern.js
new file mode 100644
index 00000000000..2548adfdab6
--- /dev/null
+++ b/docs/pages/example/fill-pattern.js
@@ -0,0 +1,10 @@
+/*---
+title: Add a pattern to a polygon
+description: Use [fill-pattern](https://docs.mapbox.com/mapbox-gl-js/style-spec/#paint-fill-fill-pattern) to draw a polygon from a repeating image pattern.
+tags:
+  - layers
+pathname: /mapbox-gl-js/example/fill-pattern/
+---*/
+import Example from '../../components/example';
+import html from './fill-pattern.html';
+export default Example(html);