diff --git a/docs/reference/cat/nodes.asciidoc b/docs/reference/cat/nodes.asciidoc
index c6b62f6bf1a..1c77f17d7e4 100644
--- a/docs/reference/cat/nodes.asciidoc
+++ b/docs/reference/cat/nodes.asciidoc
@@ -42,10 +42,12 @@ Valid columns are:
 (Default) Used file descriptors percentage, such as `1`.
 
 `node.role`, `r`, `role`, `nodeRole`::
-(Default) Roles of the node. Returned values include `m` (master-eligible node),
-`d` (data node), `i` (ingest node), `v` (voting-only node), and `-` (coordinating node only).
+(Default) Roles of the node. Returned values include `d` (data node), `i`
+(ingest node), `m` (master-eligible node), `l` (machine learning node), `v`
+(voting-only node), and `-` (coordinating node only).
 +
-For example, `mdi` indicates a master-eligible data and ingest node.
+For example, `dim` indicates a master-eligible data and ingest node. See
+<<modules-node>>.
 
 `master`, `m`::
 (Default) Indicates whether the node is the elected master node. Returned values
diff --git a/docs/reference/cluster.asciidoc b/docs/reference/cluster.asciidoc
index 271a7d7fbbb..6f224809adc 100644
--- a/docs/reference/cluster.asciidoc
+++ b/docs/reference/cluster.asciidoc
@@ -20,14 +20,14 @@ one of the following:
 * an IP address or hostname, to add all matching nodes to the subset.
 * a pattern, using `*` wildcards, which adds all nodes to the subset
   whose name, address or hostname matches the pattern.
-* `master:true`, `data:true`, `ingest:true`, `voting_only:true` or
+* `master:true`, `data:true`, `ingest:true`, `voting_only:true`, `ml:true`, or
   `coordinating_only:true`, which respectively add to the subset all
   master-eligible nodes, all data nodes, all ingest nodes, all voting-only
-  nodes, and all coordinating-only nodes.
-* `master:false`, `data:false`, `ingest:false`, `voting_only:true`, or
-  `coordinating_only:false`, which respectively remove from the subset all
+  nodes, all machine learning nodes, and all coordinating-only nodes.
+* `master:false`, `data:false`, `ingest:false`, `voting_only:true`, `ml:false`,
+  or `coordinating_only:false`, which respectively remove from the subset all
   master-eligible nodes, all data nodes, all ingest nodes, all voting-only
-  nodes and all coordinating-only nodes.
+  nodes, all machine learning nodes, and all coordinating-only nodes.
 * a pair of patterns, using `*` wildcards, of the form `attrname:attrvalue`,
   which adds to the subset all nodes with a custom node attribute whose name
   and value match the respective patterns. Custom node attributes are