diff --git a/doc/images/qmldesigner-states-when-condition.png b/doc/images/qmldesigner-states-when-condition.png
new file mode 100644
index 00000000000..a26ba37b52b
Binary files /dev/null and b/doc/images/qmldesigner-states-when-condition.png differ
diff --git a/doc/src/qtquick/qtquick-screens.qdoc b/doc/src/qtquick/qtquick-screens.qdoc
index 2beb1c4a359..3bf0232b851 100644
--- a/doc/src/qtquick/qtquick-screens.qdoc
+++ b/doc/src/qtquick/qtquick-screens.qdoc
@@ -391,6 +391,18 @@
 
         \endlist
 
+    \section2 Using SCXML State Machines
+
+    To use QML and \QMLD together with an SCXML state machine, add states and
+    bind them to the state machine in the \uicontrol Backends tab, as described
+    in \l {Managing C++ Backend Objects}.
+
+    In the \uicontrol States pane, you can edit the \c when condition of states
+    to map QML states to the states of the SCXML state machine. For an example,
+    see \l {Qt SCXML Traffic Light QML Example (Dynamic)}.
+
+    \image qmldesigner-states-when-condition.png
+
     \section1 Animating Screens
 
     To make movement between states smooth, you can specify transitions. You can