diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index 3a334f4282..28267101d8 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -7666,6 +7666,24 @@ system and gives an overview of their function and contents.
For information on Systemd-boot, see the `Systemd-boot
documentation `__.
+ :term:`SYSTEMD_DEFAULT_TARGET`
+
+ This variable allows to set the default unit that systemd starts at bootup.
+ Usually, this is either ``multi-user.target`` or ``graphical.target``.
+ This works by creating a ``default.target`` symbolic link to the chosen systemd
+ target file.
+
+ See `systemd's documentation
+ `__
+ for details.
+
+ For example, this variable is used in the
+ `core-image-minimal-xfce.bb
+ `__
+ recipe::
+
+ SYSTEMD_DEFAULT_TARGET = "graphical.target"
+
:term:`SYSTEMD_PACKAGES`
When inheriting the :ref:`systemd ` class,
this variable locates the systemd unit files when they are not found