diff --git a/man/systemd-nsresourced.service.xml b/man/systemd-nsresourced.service.xml
index e3ac1eb0c3..3c662d04ed 100644
--- a/man/systemd-nsresourced.service.xml
+++ b/man/systemd-nsresourced.service.xml
@@ -92,6 +92,11 @@
This service provides one Varlink service:
io.systemd.NamespaceResource allows registering user namespaces, and assign mounts,
cgroups and network interfaces to it.
+
+ Note that combining usage of systemd-nsresourced and systems based on
+ /etc/subuid and /etc/subgid might result in undefined
+ behavior if UID or GID ranges defined in those files overlap with the UID or GID ranges used by
+ nsresourced (the foreign UID range).