SharePoint Specific People Link Breaks After User Rename: What Site Owners Should Check

When a user in your organization changes their display name, SharePoint links that point to that specific person can break. These links, often created using the people picker or the Mention control in modern pages, rely on the user’s unique identifier. But the link text may still show the old name. This mismatch can confuse visitors and cause the link to fail when clicked. This article explains why the link breaks, how to identify affected links, and what steps you can take to restore them.

Why a User Rename Breaks a Specific People Link

SharePoint stores people links using the user’s unique identifier, such as the i:0#.f|membership|user@domain.com claim. When you insert a people link on a modern page, SharePoint renders the link with the user’s current display name as visible text. The underlying hyperlink contains the encoded user ID. When the user’s display name changes in Microsoft Entra ID (formerly Azure AD), the profile sync to SharePoint takes time. During that gap, the link text still shows the old name, but the ID remains valid. However, if the page’s HTML cache or the people picker control does not refresh, clicking the link may produce a “user not found” error or redirect to a broken profile page.

The issue is not a broken hyperlink in the traditional sense. The link’s URL still points to the correct user ID. The problem is the visible text label that no longer matches the user’s current name. This mismatch can cause SharePoint’s rendering engine to fail when it tries to resolve the link on the fly, especially in scenarios where the page uses the sp-persons web part or the Mention control in a text web part.

Steps to Identify and Fix Broken People Links

1. Open the affected site page in Edit mode
   Navigate to the site where the broken link appears. Click the gear icon and select Edit page. If the page is a modern page, you will enter the canvas editing interface.
2. Find the people link text web part
   Look for a text web part or a people web part that contains the user’s name. Click inside the web part to see the formatting toolbar. If the link is in a text web part, select the user name text and look for the hyperlink icon in the toolbar.
3. Check the underlying link URL
   Right-click the linked user name and select Inspect (or press F12). In the Elements tab, locate the <a> tag. The href attribute should contain a URL like https://yourtenant.sharepoint.com/:p:/...?people=user@domain.com. If the URL is missing or points to an old user ID, you need to rebuild the link.
4. Remove and reinsert the people link
   In the text web part, delete the old user name. Type the user’s new display name. Select the text and click the Insert link button in the toolbar. Choose People from the link picker. Start typing the user’s new name and select the correct entry from the dropdown. Click Insert.
5. Save and republish the page
   Click Save and then Publish to make the changes live. Test the link by clicking it in a non-editing view.
6. Trigger a full user profile sync (if many links are broken)
   Go to the SharePoint admin center. Under User profiles, select Manage user profiles. Find the renamed user, click the dropdown arrow, and choose Start full sync. This updates the profile data across all site collections. Wait up to 24 hours for the sync to complete.

If the People Link Still Does Not Work After the Main Fix

People picker does not show the new name

The people picker in SharePoint caches user names from the User Profile Service. If the rename was recent, the cache may still hold the old name. Clear your browser cache and sign out of all Microsoft 365 apps. Then sign back in. If the issue persists, ask your tenant admin to run a full profile synchronization from the SharePoint admin center.

Link works in edit mode but breaks in read mode

This usually indicates a rendering conflict with a custom script or a third-party web part. Test the page in a private browser window. If the link works there, the problem is with browser extensions or cached scripts. Disable extensions one by one to find the culprit.

Multiple pages have broken people links

When a user rename affects many pages, manual editing is inefficient. Use SharePoint PnP PowerShell to search all site pages for the old user name. The Get-PnPListItem cmdlet can retrieve page content. Then use Set-PnPListItem to update the people link text. This requires knowledge of the page’s HTML structure, so test on a single page first.

People Link Types: Manual Insert vs. Mention Control

Item	Manual Insert via Link Picker	Mention Control (@mention)
How the link is created	User types a name, selects People from link picker, and inserts	User types @ followed by the name, selects from dropdown
Underlying data	Stores the user ID as a hyperlink with display name text	Stores the user ID in a special data-sp-people attribute
Behavior after rename	Display name text becomes outdated; link may fail on click	Display name updates automatically after profile sync
How to fix	Manually edit the link text and reinsert using link picker	No manual fix needed; wait for profile sync or trigger full sync

The Mention control is more resilient because it stores the user ID in an attribute that SharePoint renders dynamically. Manual people links are static text that must be updated by a site owner.

As a site owner, you can now identify which pages use manual people links and update them after a user rename. For future changes, encourage editors to use the @mention control instead of the manual link picker. This reduces the maintenance burden. If you manage many sites, consider running a periodic PowerShell script to detect pages with outdated people links.