diff --git a/share/man/man7/named_attribute.7.dup b/share/man/man7/named_attribute.7
--- a/share/man/man7/named_attribute.7.dup
+++ b/share/man/man7/named_attribute.7
@@ -3,7 +3,7 @@
 .\"
 .\" SPDX-License-Identifier: BSD-2-Clause
 .\"
-.Dd July 20, 2025
+.Dd August 5, 2025
 .Dt NAMED_ATTRIBUTE 7
 .Os
 .Sh NAME
@@ -153,6 +153,23 @@
 will make the attribute(s) visible as both named attributes
 and via
 .Xr extattr 2 .
+If is also possible to create two attributes with the same
+name by creating one when the ZFS
+.Dv xattr
+property is set to
+.Dq sa
+and then creating another one with the same name after the ZFS
+property
+.Dv xattr
+has been changed to
+.Dq dir .
+To avoid these issues, it is strongly recommended that the ZFS
+property
+.Dv xattr
+be set to
+.Dq dir
+as soon as the file system is created, if named attributes
+are to be used on the file system.
 .El
 .Pp
 The named attribute mechanism/system call interface provides certain