diff --git a/plugins/search/README.md b/plugins/search/README.md
index 3803b71e43..ae51c3a554 100644
--- a/plugins/search/README.md
+++ b/plugins/search/README.md
@@ -8,6 +8,18 @@ Development is ongoing. You can follow the progress and contribute at the Backst
 
 Run `yarn dev` in the root directory, and then navigate to [/search](http://localhost:3000/search) to check out the plugin.
 
+### Optional Settings
+
+Configure the initialState of the search component in your `app-config.yaml` to defines how it behaves when it is first loaded or reset.
+
+```yaml
+# app-config.yaml
+app:
+  search:
+    initialState:
+      pageLimit: 50
+```
+
 ### Areas of Responsibility
 
 This search plugin is primarily responsible for the following: