diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 48de91cf989..81ba58d38d8 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -482,6 +482,9 @@ To work with multi-dimensional fields::
+
+
+
Pass an array of values::
@@ -495,6 +498,11 @@ Pass an array of values::
'dimensional' => 'an other value',
]]);
+ // tick multiple checkboxes at once
+ $form->setValues(['multi' => [
+ 'dimensional' => [1, 3] // it uses the input value to determine which checkbox to tick
+ ]]);
+
This is great, but it gets better! The ``Form`` object allows you to interact
with your form like a browser, selecting radio values, ticking checkboxes,
and uploading files::