Specific People Link Breaks After User Rename: Root Cause and Fix

When a user changes their display name in Microsoft 365, any Specific People link they created in a SharePoint document library breaks. The link no longer resolves to the intended person, and users see an error or an unresolvable name instead of a clickable contact. This happens because SharePoint stores the user’s email address or user principal name (UPN) in the link metadata, but the link’s underlying identifier does not update when the user’s name changes. This article explains why the link breaks and provides the exact steps to fix the broken links and prevent the issue from recurring.

Why Renaming a User Breaks Specific People Links

When you create a Specific People link in a SharePoint document library, SharePoint stores a reference to the user. This reference is not the user’s display name. Instead, SharePoint stores the user’s email address or UPN in the link’s underlying metadata. The link displays the user’s current display name at the time of creation, but the actual value that makes the link work is the email or UPN.

When an administrator renames a user in Microsoft 365, the user’s display name changes. However, the email address and UPN often remain the same or are updated separately. If the email or UPN changes as part of the rename, the stored reference in the SharePoint link becomes stale. The link still points to the old email or UPN, which no longer resolves to a valid user. As a result, the link breaks and displays the unresolvable name or an error.

Another scenario is when the user’s object ID changes, such as when a user is deleted and recreated with the same name. SharePoint stores the object ID for People columns. If the object ID changes, the link cannot find the user. This is less common but happens in environments that frequently clean up and recreate user accounts.

The Role of the People Column Type

SharePoint People columns store a user identifier. The identifier can be the email address, UPN, or Active Directory object ID. The column displays the display name, but the underlying value is the identifier. When you rename a user, the display name updates everywhere in SharePoint except in the Specific People link metadata. The link retains the old identifier. If the identifier is the email address and the email address changes, the link breaks. If the identifier is the UPN and the UPN changes, the link breaks. If the identifier is the object ID and the user is recreated, the link breaks.

Steps to Fix Broken Specific People Links

To fix a broken Specific People link, you must update the underlying user identifier stored in the People column. The method depends on whether the user’s email address or UPN changed.

1. Identify the broken link
   Open the SharePoint document library that contains the broken link. Click the link. If the link shows an unresolvable name or an error, the user identifier is stale. Note the current display name shown in the link.
2. Find the user’s new email and UPN
   Go to the Microsoft 365 admin center at admin.microsoft.com. Select Users > Active users. Find the renamed user. Copy the new email address and UPN from the user’s profile.
3. Update the People column value in SharePoint
   Use SharePoint PowerShell to update the People column. Open PowerShell and connect to SharePoint using Connect-PnPOnline -Url "https://yourtenant.sharepoint.com/sites/yoursite" -Interactive. Then run: Set-PnPListItem -List "Documents" -Identity 1 -Values @{"PeopleColumn" = "user@newdomain.com"} Replace 1 with the item ID, Documents with your library name, and PeopleColumn with the actual column name. This overwrites the stale identifier with the new email.
4. Verify the link works
   Refresh the document library page. Click the link. It should now display the user’s new display name and resolve correctly. If the link still shows an error, repeat step 3 using the UPN instead of the email.
5. Update all links for the same user
   If the user appears in multiple links across the site, run the PowerShell command for each item. To find all items that reference the old user, use: Get-PnPListItem -List "Documents" | Where-Object { $_.FieldValues.PeopleColumn -match "olddomain.com" } Then update each item.

Alternative Method: Edit the Column Value in the Browser

If you have only one or two broken links, you can update them directly in the browser. Open the document library. Select the item that contains the broken link. Click the ellipsis (three dots) and select Details. In the details pane, find the People column. Clear the existing value and type the user’s new name. SharePoint will resolve the new name and store the correct identifier. Save the changes.

If the Link Still Does Not Work After the Update

The user was deleted and recreated

If the user account was deleted and recreated with the same display name and email, the object ID is different. SharePoint stores the object ID in the People column. The link cannot resolve the old object ID. To fix this, remove the old value from the People column and add the user again. Use the browser method described above. The link will then store the new object ID.

The People column is read-only

Some People columns are configured as read-only in the library settings. You cannot update them through the browser. Use PowerShell with the -SystemUpdate parameter to bypass read-only restrictions: Set-PnPListItem -List "Documents" -Identity 1 -Values @{"PeopleColumn" = "user@newdomain.com"} -SystemUpdate

The link is in a SharePoint Server on-premises environment

SharePoint Server on-premises stores users by their Active Directory security identifier (SID). If the user is renamed but not recreated, the SID remains the same. The link should still work. If the link breaks, run an incremental user profile synchronization in SharePoint Central Administration. This updates the display name and resolves the link.

Specific People Link Behavior: Original vs After Rename

Item	Original Link	After Rename
Display name shown	Old display name	Unresolvable or blank
Underlying identifier	Old email or UPN	Stale identifier
Click behavior	Opens contact card	Error or no action
Fix method	Not applicable	Update column value with new identifier

After fixing the link, the display name shows the user’s new name, and the link opens the correct contact card. The underlying identifier now matches the current user account.

To prevent this issue, use a People column with column validation that stores the email address. When a user is renamed, update the email in Microsoft 365 and the link will still work because the email address stays the same. Alternatively, avoid renaming users who are referenced in Specific People links. If renaming is necessary, plan to update all links immediately after the change.