diff --git a/docs/upgrading.rst b/docs/upgrading.rst
index 9155d76909c906b3c35ab166d208aa2cb804ef20..fed8c7e95a887d6bf9acdac6df155c8035b8e928 100644
--- a/docs/upgrading.rst
+++ b/docs/upgrading.rst
@@ -75,12 +75,17 @@ Nextcloud
 ~~~~~~~~~
 
 Your SSO users will have new usernames, because the OIDC provider has been
-renamed from ``oas`` to ``stackspin``. You can choose from these options:
+renamed from ``oas`` to ``stackspin`` and because the new SSO system uses UUIDs
+to uniquely identify users.
+
+You can choose from these options:
 
 1. Manually re-upload and re-share your files after logging into your new user
    for the first time.
 2. It is possible to transfer files from your previous user to the new user. To
-   do so:
+   do so, find your new username. It is visible in Settings -> Sharing behind
+   "Your Federated Cloud ID" after you've logged out and in to Nextcloud with
+   the new SSO (the part *before* the ``@``).
 
    .. code:: bash
 
@@ -89,7 +94,7 @@ renamed from ``oas`` to ``stackspin``. You can choose from these options:
       # Change to the www-data user
       su www-data -s /bin/bash
       # Repeat this command for each username
-      php occ files:transfer-ownership oas-<username> stackspin-<username>
+      php occ files:transfer-ownership oas-<old username> <new user ID>
       # Note: the files are tranferred to a subfolder in the new user's
       # directory