Update Teams Channel Tab display name using PnP PowerShell
Introduction
Renaming the ‘Files’ tab in Microsoft Teams to something more meaningful for your business, such as “All Access,” can enhance user experience. It can help to differentiate other document libraries added as tabs. The Files has been renamed to Shared for chats to show all the files and links that were sent in the chat, making it easier to find them- all in one place.
However, it is not possible to rename the Files and Posts tabs from the UI within channels. I attempted to use PnP PowerShell to achieve this but encountered an error:
Set-PnPTeamsTab: Bad Request (400): Patch operation not allowed on static tabs
This blog post provides a sample script for renaming other custom tabs using PnP PowerShell.
PnP PowerShell Sample Script
Attempt to Rename/remove ‘Files’ Tab
Rename ‘Files’ Tab
Set-PnPTeamsTab -Team "f67aa1d6-500c-49f1-9ff6-76fc55c8afa7" -Channel "19:_7BUDIBRPgps9XrLf5QlJ7004vIF5aQy8rsELvHQ9fo1@thread.tacv2" -Identity "Files" -DisplayName "All Access"
Or using display name:
Set-PnPTeamsTab -Team "TestChannel" -Channel "General" -Identity "Files" -DisplayName "All Access"
Set-PnPTeamsTab: Bad Request (400): Patch operation not allowed on static tabs
Remove ‘Files’ Tab
Remove-PnPTeamsTab -Team "TestChannel" -Channel "General" -Identity "Files" -force
Attempting to remove a permananent tab resulted in error message
Remove-PnPTeamsTab: Call to Microsoft Graph URL https://graph.microsoft.com/v1.0/teams/f67aa1d6-500c-49f1-9ff6-76fc55c8afa7/channels/19:_7BUDIBRPgps9XrLf5QlJ7004vIF5aQy8rsELvHQ9fo1@thread.tacv2/tabs/3ed5b337-c2c9-4d5d-b7b4-84ff09a8fc1c failed with status code Forbidden: Delete operation is not allowed on a permanent tab (tabId: 3ed5b337-c2c9-4d5d-b7b4-84ff09a8fc1c)
Renaming/Removing Custom Tabs
Rename custom tab While renaming the ‘Files’ tab is not allowed, you can rename other custom tabs using the following cmdlet:
Set-PnPTeamsTab -Team "TestChannel" -Channel "General" -Identity "Company Phone" -DisplayName "Phone"
Remove custom tab
Remove-PnPTeamsTab -Team "TestChannel" -Channel "General" -Identity "Company Phone" -DisplayName "Phone"
Note on CLI for M365
As of December 12, 2025, the CLI for M365 does not have a cmdlet to set the display name of Teams tabs.
Conclusion
Renaming static tabs like ‘Files’ and ‘Posts’ in Microsoft Teams is not supported via PnP PowerShell or the UI. However, other custom tabs can be renamed using the Set-PnPTeamsTab cmdlet. This can help make your Teams environment more intuitive and user-friendly.
Anyone who knows a workaround, do reach out.