From a96b8da3e2a60d2d19820cc39a3193452a209f28 Mon Sep 17 00:00:00 2001
From: "Carrie Warner (Mattermost)"
 <74422101+cwarnermm@users.noreply.github.com>
Date: Tue, 16 Sep 2025 08:23:40 -0400
Subject: [PATCH] Update environment-configuration-settings.rst

---
 .../environment-configuration-settings.rst    | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/source/administration-guide/configure/environment-configuration-settings.rst b/source/administration-guide/configure/environment-configuration-settings.rst
index 5b722972c09..355fe1a0aad 100644
--- a/source/administration-guide/configure/environment-configuration-settings.rst
+++ b/source/administration-guide/configure/environment-configuration-settings.rst
@@ -814,6 +814,25 @@ Maximum open connections
 | deployments, and **100** for Cloud deployments.        |                                                                         |
 +--------------------------------------------------------+-------------------------------------------------------------------------+
 
+.. config:setting:: maximum-idle-connections
+  :displayname: Maximum idle connections (Database)
+  :systemconsole: Environment > Database
+  :configjson: .SqlSettings.MaxIdleConns
+  :environment: MM_SQLSETTINGS_MAXIDLECONNS
+  :description: The maximum number of idle connections held open to the database. Default is **50**.
+
+Maximum idle connections
+~~~~~~~~~~~~~~~~~~~~~~~~
+
++--------------------------------------------------------+-------------------------------------------------------------------------+
+| The maximum number of idle connections held open to    | - System Config path: **Environment > Database**                        |
+| the database.                                          | - ``config.json`` setting: ``SqlSettings`` > ``MaxIdleConns`` > ``50``  |
+|                                                        | - Environment variable: ``MM_SQLSETTINGS_MAXIDLECONNS``                 |
+| Numerical input. Default is **50**.                    |                                                                         |
+| A 2:1 ratio with MaxOpenConns is recommended.          |                                                                         |
+| database.                                              |                                                                         |
++--------------------------------------------------------+-------------------------------------------------------------------------+
+
 .. config:setting:: query-timeout
   :displayname: Query timeout (Database)
   :systemconsole: Environment > Database