diff --git a/doc/build/dts/macros.bnf b/doc/build/dts/macros.bnf
index 034b11142ae16..2f4d7d6875785 100644
--- a/doc/build/dts/macros.bnf
+++ b/doc/build/dts/macros.bnf
@@ -103,8 +103,9 @@ node-macro =/ %s"DT_N" path-id %s"_FOREACH_CHILD_STATUS_OKAY_SEP_VARGS"
 node-macro =/ %s"DT_N" path-id %s"_FOREACH_NODELABEL" [ %s"_VARGS" ]
 ; These are used internally by DT_NUM_NODELABELS
 node-macro =/ %s"DT_N" path-id %s"_NODELABEL_NUM"
-; The node's zero-based index in the list of it's parent's child nodes.
-node-macro =/ %s"DT_N" path-id %s"_CHILD_IDX"
+; Macros which expand to the node identifiers for each child by index.
+node-macro =/ %s"DT_N" path-id %s"_CHILD_IDX_" DIGIT
+node-macro =/ %s"DT_N" path-id %s"_CHILD_IDX_" 2*DIGIT
 ; The node's status macro; dt-name in this case is something like "okay"
 ; or "disabled".
 node-macro =/ %s"DT_N" path-id %s"_STATUS_" dt-name