1 files changed, 46 insertions, 0 deletions
diff --git a/toolkit/components/search/docs/Preferences.rst b/toolkit/components/search/docs/Preferences.rst
new file mode 100644
index 0000000000..2fdf4699cb
--- /dev/null
+++ b/toolkit/components/search/docs/Preferences.rst
@@ -0,0 +1,46 @@
+Preferences
+===========
+
+This document describes Preferences affecting the toolkit Search Service.
+Preferences that are generated and updated by code won't be described here.
+
+User Exposed
+------------
+These preferences are exposed through the Firefox UI.
+
+browser.search.suggest.enabled (default: true)
+  Whether search suggestions are enabled in the search bar. Turning this off
+  also currently prevents search suggestions in the address bar.
+
+Hidden
+------
+These preferences are normally hidden, and should not be used unless you really
+know what you are doing.
+
+browser.search.log (boolean, default: false)
+  Whether search service console logging is enabled or not.
+
+browser.search.suggest.timeout (number, default: 500)
+  When requesting suggestions from a search server, it has this long to respond.
+
+browser.search.update (boolean, default: true)
+  Whether updates are enabled for OpenSearch based engines. This only applies
+  to OpenSearch engines where their definition supplies an update url.
+  Note that this does not affect any of: application updates, add-on updates,
+  remote settings updates.
+
+Experimental
+------------
+These preferences are experimental and not officially supported. They could be
+removed at any time.
+
+browser.search.separatePrivateDefault.ui.enabled (boolean, default: false)
+  Whether the UI is enabled for having a separate default search engine in
+  private browsing mode.
+
+browser.search.separatePrivateDefault (boolean, default: false)
+  Whether the user has selected to have a separate default search engine in
+  private browsing mode.
+
+browser.search.suggest.enabled.private (boolean, default: false)
+  Whether search suggestions are enabled in a private browsing window.