diff --git a/modules/rest-api/pages/rest-reader-writer-thread-config.adoc b/modules/rest-api/pages/rest-reader-writer-thread-config.adoc
index 797f2b369c..f4b32a8ef2 100644
--- a/modules/rest-api/pages/rest-reader-writer-thread-config.adoc
+++ b/modules/rest-api/pages/rest-reader-writer-thread-config.adoc
@@ -100,8 +100,8 @@ To set the global thread allocations for Couchbase Server, send a `POST` to the
 ----
 curl -X POST http[s]://{host}:{port}/pools/default/settings/memcached/global
   -u $USER:$PASSWORD
-  [-d num_reader_threads=<integer>]
-  [-d num_writer_threads=<integer>]
+  [-d num_reader_threads=<integer>|disk_io_optimized]
+  [-d num_writer_threads=<integer>|disk_io_optimized]
   [-d num_nonio_threads=<integer>]
   [-d num_auxio_threads=<integer>]
   [-d num_storage_threads=<integer>]
@@ -118,9 +118,13 @@ include::partial$user_pwd_host_port_params.adoc[]
 
 `num_reader_threads`::
 (optional) Sets the number of threads Couchbase Server uses to read data.
+Accepts an integer, or `disk_io_optimized` to allocate threads equal to the number of CPU cores on the node.
+For guidance on when to choose `disk_io_optimized`, particularly for buckets that use the Magma storage engine, see xref:manage:manage-settings/general-settings.adoc#data-settings[Data Settings].
 
 `num_writer_threads`:: 
 (optional) Sets the number of threads Couchbase Server uses to write data.
+Accepts an integer, or `disk_io_optimized` to allocate threads equal to the number of CPU cores on the node.
+For guidance on when to choose `disk_io_optimized`, particularly for buckets that use the Magma storage engine, see xref:manage:manage-settings/general-settings.adoc#data-settings[Data Settings].
 
 `num_nonio_threads`:: 
 (optional) Sets the number of NonIO threads to be used by Couchbase Server.