Renaming a SharePoint List or Library: Why the URL Doesn't Change, How to Change It, and What Breaks

Renaming a list or library in SharePoint changes only its title. The URL keeps the name it was created with, so a library created as "Abcd" and renamed "Salvos Project Research" still lives at /Abcd. To change the URL you have to move the root folder with PowerShell, and when you do, every link that uses the old path returns 404: SharePoint adds no redirect. Find and fix the links first, for example with the free SharePoint Essentials Toolkit.

Published:

Last updated: 2026-10-29

Rename changes the title, not the URL

We created a library called Client Deliverables, then renamed it in List settings. The title changed; the URL stayed /sites/architecture-knowledge-base/Client Deliverables. The same happens with Rename in Site contents and with Set-PnPList -Title.

That's why so many libraries have URLs that don't match their names. On our demo site, several don't, for example:

TitleURL
Salvos Project Research/sites/architecture-knowledge-base/Abcd
Handover Documents/sites/architecture-knowledge-base/Handover
Documents/sites/architecture-knowledge-base/Shared Documents
SharePoint Essentials Toolkit List Inventory with Title next to Url: Salvos Project Research at /Abcd, Handover Documents at /Handover, Documents at /Shared Documents
Title next to URL for every list on the site. A mismatch means the list was renamed or created with a different name.

Keeping the URL is the safe default: links, sync, flows and apps that use the path keep working after a rename.

Changing the URL breaks every path link

To change the URL we moved the library's root folder to /Handover. Afterwards:

URLResult
Old library URL (/Client Deliverables/Forms/AllItems.aspx)404 NOT FOUND
Old file URL (/Client Deliverables/file.docx)404
New file URL (/Handover/file.docx)200
Browser showing 404 NOT FOUND for the old Client Deliverables library URL
The old library URL after the move. SharePoint doesn't redirect it.

What uses the path and breaks:

  • Links in pages, Quick Links and other web parts, and site navigation.
  • Links inside Word, Excel, PowerPoint and PDF files, including Excel data connections and linked workbooks.
  • Power Automate flows and Power Apps that use the library path, and Teams tabs.
  • Bookmarks and links in emails.
  • OneDrive sync of that library: users have to stop syncing and sync again.

What keeps working: links that use the file's ID instead of its path. Document ID links (DocIdRedir.aspx?ID=...) and sharing links find the file wherever it is in the site collection.

Option 1: Rename safely with built-in settings

  1. To change only what people see, rename: Settings, Library settings, List name, description and navigation. Nothing breaks.
  2. To change the URL without PowerShell, create a new library with the URL you want and Move to the files into it. Move keeps versions and metadata within a tenant, but it's still a URL change for every file, so the same links break. See moving files between sites.
  3. Before either URL change, turn on the Document ID service so new links are ID-based.

Option 2: Change the URL with PowerShell

SharePoint has no setting for a list URL, but moving the root folder changes it. This PnP PowerShell script shows what would change and only moves when you set $WhatIf = $false. It needs PnP PowerShell 2.x and your own Entra ID app registration.

$ClientId = "<your-app-id>"
$SiteUrl  = "https://contoso.sharepoint.com/sites/Projects"
$List     = "Salvos Project Research"
$NewName  = "SalvosResearch"        # last part of the new URL, no spaces is safest
$WhatIf   = $true

Connect-PnPOnline -Url $SiteUrl -Interactive -ClientId $ClientId
$l   = Get-PnPList -Identity $List -Includes RootFolder.ServerRelativeUrl, ParentWebUrl
$old = $l.RootFolder.ServerRelativeUrl
$new = ($l.ParentWebUrl.TrimEnd('/') + "/" + $NewName)
"Title   : {0}`nOld URL : {1}`nNew URL : {2}`nItems   : {3}" -f $l.Title, $old, $new, $l.ItemCount

if ($WhatIf) { "WhatIf: nothing moved. Every link that starts with $old will return 404 afterwards." }
else {
    $l.RootFolder.MoveTo($new)
    Invoke-PnPQuery
    (Get-PnPList -Identity $l.Id -Includes RootFolder.ServerRelativeUrl).RootFolder.ServerRelativeUrl
}

For lists (not libraries) the URL usually includes /Lists/; keep it in $new. Move the root folder of a library with retention labels or holds only after checking with your compliance team.

Option 3: Find and fix the links with SharePoint Essentials Toolkit

The work in a URL change is the links. The toolkit's Links area covers both sides of it:

SharePoint Essentials Toolkit Links area: Find broken links, Link Inventory, Find one or more specific links, Fix or replace links in bulk, and Prepare site for link correction
Find broken links, inventory them, or replace them in bulk.
  1. Before the change: run Find one or more specific links for the old path across every site that might link to it, so you know what will break.
  2. After the change: run Fix or replace links in bulk with a rule that replaces the old path with the new one. It rewrites links in pages, web parts, navigation, list columns and inside Office and PDF files.
Fix or replace links in bulk: Flag only on, find links that contain /sites/architecture-knowledge-base/Abcd/ and replace the matched part with /sites/architecture-knowledge-base/SalvosResearch/, Preserve Author on
One rule turns /Abcd/ into /SalvosResearch/. Flag only reports what would change first; Preserve Author keeps Modified By.

Run it with Flag only on to see every link it would change, then turn it off to apply. Changes can be undone from History. For moves between sites, Prepare site for link correction records every link form of every file before the move and builds the replace rules afterwards.

Community Edition is free on up to 20 sites per Microsoft 365 tenant.

Frequently asked questions

Why didn't my SharePoint library URL change when I renamed it?

Renaming changes only the title. The URL keeps the name the list or library was created with, so links and sync keep working.

How do I change a SharePoint document library URL?

Move the library's root folder with PowerShell ($list.RootFolder.MoveTo(newUrl)), or create a new library with the URL you want and move the files into it. Both break links that use the old path.

Does SharePoint redirect the old library URL after a URL change?

No. In our test the old library URL and the old file URLs returned 404, and only the new URLs worked.

Which links keep working after a SharePoint library URL change?

Links based on the file's ID: Document ID links (DocIdRedir.aspx) and sharing links. Path links in pages, navigation, documents, flows, Teams tabs and bookmarks break.

How do I fix links after changing a SharePoint URL?

Find every link that contains the old path, then replace the old path with the new one in pages, navigation, list columns and documents. A bulk find and replace tool with a preview mode is the fastest way.

Change SharePoint URLs without breaking links, free

SharePoint Essentials Toolkit Community Edition is free. Find every link to an old path, then replace it in pages, navigation and documents with a preview first, on up to 20 sites per Microsoft 365 tenant. Get your free Community Edition license key.

About the author. The Cognillo SharePoint Team builds and supports SharePoint Essentials Toolkit and has worked with SharePoint administrators on permissions audits, migrations and cleanup projects since 2012.