From 0a7815d2038255a0834c955066a2a16c01f707b2 Mon Sep 17 00:00:00 2001
From: Simon Willison <swillison@gmail.com>
Date: Tue, 6 Sep 2022 11:06:49 -0700
Subject: [PATCH] Documentation for facet_size in metadata, closes #1804

---
 docs/facets.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/facets.rst b/docs/facets.rst
index 2a2eb039..6c9d99bd 100644
--- a/docs/facets.rst
+++ b/docs/facets.rst
@@ -129,6 +129,22 @@ You can specify :ref:`array <facet_by_json_array>` or :ref:`date <facet_by_date>
     ]
   }
 
+You can change the default facet size (the number of results shown for each facet) for a table using ``facet_size``:
+
+.. code-block:: json
+
+    {
+      "databases": {
+        "sf-trees": {
+          "tables": {
+            "Street_Tree_List": {
+              "facets": ["qLegalStatus"],
+              "facet_size": 10
+            }
+          }
+        }
+      }
+    }
 
 Suggested facets
 ----------------