diff --git a/man/repart.d.xml b/man/repart.d.xml
index 846e1984e59..b7862029057 100644
--- a/man/repart.d.xml
+++ b/man/repart.d.xml
@@ -425,6 +425,12 @@
target filesystem (e.g symlinks, fifos, sockets and devices on vfat). When an unsupported file type
is encountered, repart will skip copying this file and write a log message about it.
+ Note that systemd-repart does not change the UIDs/GIDs of any copied files
+ and directories. When running systemd-repart as an unprivileged user to build an
+ image of files and directories owned by the same user, you can run systemd-repart
+ in a user namespace with the current user mapped to the root user to make sure the files and
+ directories in the image are owned by the root user.
+
This option cannot be combined with CopyBlocks=.
When