From 3790defc2cad4201c5b26a95d8023a16479ea983 Mon Sep 17 00:00:00 2001
From: Samuel Newbold <sam@rwsh.org>
Date: Fri, 6 Mar 2026 08:35:54 -0500
Subject: [PATCH] TOML integer log levels must be quoted: Updating reference
 documentation  (#14255)

Fixes #14253

(cherry picked from commit 2755310d51bf6f9a307fcb89b4f1712fbc8f7dc5)
---
 changelog/14255.doc.rst        |  1 +
 doc/en/reference/reference.rst | 15 ++++++++++++---
 2 files changed, 13 insertions(+), 3 deletions(-)
 create mode 100644 changelog/14255.doc.rst

diff --git a/changelog/14255.doc.rst b/changelog/14255.doc.rst
new file mode 100644
index 00000000000..b96d2c2a1b9
--- /dev/null
+++ b/changelog/14255.doc.rst
@@ -0,0 +1 @@
+TOML integer log levels must be quoted: Updating reference documentation.
diff --git a/doc/en/reference/reference.rst b/doc/en/reference/reference.rst
index 27d3f5e721a..3760add53cf 100644
--- a/doc/en/reference/reference.rst
+++ b/doc/en/reference/reference.rst
@@ -1836,7 +1836,8 @@ passed multiple times. The expected format is ``name=value``. For example::
 
 
     Sets the minimum log message level that should be captured for live logging. The integer value or
-    the names of the levels can be used.
+    the names of the levels can be used. Note in TOML the integer must be quoted, as there is no support
+    for config parameters of mixed type.
 
     .. tab:: toml
 
@@ -1844,6 +1845,7 @@ passed multiple times. The expected format is ``name=value``. For example::
 
             [pytest]
             log_cli_level = "INFO"
+            log_cli_level = "10"
 
     .. tab:: ini
 
@@ -1851,6 +1853,7 @@ passed multiple times. The expected format is ``name=value``. For example::
 
             [pytest]
             log_cli_level = INFO
+            log_cli_level = 10
 
     For more information, see :ref:`live_logs`.
 
@@ -1951,7 +1954,8 @@ passed multiple times. The expected format is ``name=value``. For example::
 
 
     Sets the minimum log message level that should be captured for the logging file. The integer value or
-    the names of the levels can be used.
+    the names of the levels can be used. Note in TOML the integer must be quoted, as there is no support
+    for config parameters of mixed type.
 
     .. tab:: toml
 
@@ -1959,6 +1963,7 @@ passed multiple times. The expected format is ``name=value``. For example::
 
             [pytest]
             log_file_level = "INFO"
+            log_cli_level = "10"
 
     .. tab:: ini
 
@@ -1966,6 +1971,7 @@ passed multiple times. The expected format is ``name=value``. For example::
 
             [pytest]
             log_file_level = INFO
+            log_cli_level = 10
 
     For more information, see :ref:`logging`.
 
@@ -2020,7 +2026,8 @@ passed multiple times. The expected format is ``name=value``. For example::
 
 
     Sets the minimum log message level that should be captured for logging capture. The integer value or
-    the names of the levels can be used.
+    the names of the levels can be used. Note in TOML the integer must be quoted, as there is no support
+    for config parameters of mixed type.
 
     .. tab:: toml
 
@@ -2028,6 +2035,7 @@ passed multiple times. The expected format is ``name=value``. For example::
 
             [pytest]
             log_level = "INFO"
+            log_cli_level = "10"
 
     .. tab:: ini
 
@@ -2035,6 +2043,7 @@ passed multiple times. The expected format is ``name=value``. For example::
 
             [pytest]
             log_level = INFO
+            log_cli_level = 10
 
     For more information, see :ref:`logging`.