diff --git a/documentation/migration-guides/migration-6.1.rst b/documentation/migration-guides/migration-6.1.rst
index 2e103f0b7..a73c4e34a 100644
--- a/documentation/migration-guides/migration-6.1.rst
+++ b/documentation/migration-guides/migration-6.1.rst
@@ -34,6 +34,32 @@ On the other hand, some earlier distributions are no longer supported:
 
 See :ref:`all supported distributions <system-requirements-supported-distros>`.
 
+.. _ref-migration-6-1-groupmems:
+
+useradd: replace :term:`GROUPMEMS_PARAM` assignments to :term:`USERMOD_PARAMS`
+------------------------------------------------------------------------------
+
+The ``groupmems`` command is removed from the ``shadow`` recipe starting from
+version 4.20. The same functionality provided by ``groupmems`` can be achieved
+with the ``usermod`` command.
+
+Assignments made to the :term:`GROUPMEMS_PARAM` variable can be converted to use
+:term:`USERMOD_PARAMS`, by replacing::
+
+   GROUPMEMS_PARAM:${PN} = "--add user --group group1; \
+                            --add user --group group2"
+
+With::
+
+   USERMOD_PARAM:${PN} = "--append --groups group1 user; \
+                          --append --groups group2 user"
+
+Or written more simply as::
+
+   USERMOD_PARAM:${PN} = "--append --groups group1,group2 user"
+
+See (:oecore_rev:`b8da733ab12c64503a353d5ceb2eb63fed95d851`) for more details.
+
 Removed recipes
 ---------------