diff --git a/doc/develop/test/twister.rst b/doc/develop/test/twister.rst
index f0c5bbf7672..3999e6c9601 100644
--- a/doc/develop/test/twister.rst
+++ b/doc/develop/test/twister.rst
@@ -341,6 +341,23 @@ extra_args: <list of extra arguments>
     Extra arguments to pass to build tool when building or running the
     test scenario.
 
+    Using namespacing, it is possible to apply extra_args only to some
+    hardware. Currently architectures/platforms/simulation are supported:
+
+    .. code-block:: yaml
+
+        common:
+          tags: drivers adc
+        tests:
+          test:
+            depends_on: adc
+          test_async:
+            extra_args:
+              - arch:x86:CONFIG_ADC_ASYNC=y
+              - platform:qemu_x86:CONFIG_DEBUG=y
+              - platform:mimxrt1060_evk:SHIELD=rk043fn66hs_ctg
+              - simulation:qemu:CONFIG_MPU=y
+
 extra_configs: <list of extra configurations>
     Extra configuration options to be merged with a main prj.conf
     when building or running the test scenario. For example: