MC1179157 - (Update) Updated SharePoint document library user experience

Updated November 5, 2025: We have updated the timeline. Thank you for your patience. 

Introduction

Microsoft is introducing a refreshed user experience for SharePoint document libraries to improve usability and navigation. These updates are based on customer feedback and aim to streamline common actions, enhance visibility of filters and views, and improve folder navigation—all without disrupting existing customizations.

This message is associated with Roadmap ID 500870.

When this will happen:

• Targeted Release: Begins early November 2025 and completes by mid-December 2025 (previously late November).
• General Availability (Worldwide, GCC, GCC High, and DoD): Begins early January 2026 and completes by late January 2026.

How this affects your organization:

• Who is affected:
  • All users of SharePoint document libraries across Microsoft 365 tenants.
  • Note: Some users may have access to this feature before other users within your organization.
• What will happen:
• Simplified command bar: The command bar has been reorganized for clarity and efficiency. The "New" and "Upload" actions are now combined into a single "Create or Upload" hero button, docked at the upper right.
• Improved breadcrumb navigation: The breadcrumb has been redesigned to make navigating between folders faster and more intuitive. Users can now:
  • See their current folder context clearly.
  • Jump back to any parent folder with a single click.
  • Use the dropdown next to the folder name in the breadcrumb to create folders or upload files directly into the current folder.
  • When at the root of a library, use the "Other Libraries" sub-menu to navigate between libraries in the same site.
• More visible custom views, view creation, and view saving: Custom views and view creation are now displayed more prominently inside pills directly under the breadcrumb. When sorts, filters, or groups are applied but not saved to the view, a visual indicator shows that others won’t see these changes until they’re saved.
• Filter pills: Filter pills provide a faster way to refine your view. Instead of opening the full filter pane, users can:
  • Apply file type filters directly from the pill bar at the top of the document library.
  • See all active filters as pills in this bar.
  • Use the clear button to remove all filters and return to the saved view.
• View options button: Common view customization options are now surfaced under a new "Options" button, including:
  • Layout options
  • Sort and group options
  • Field visibility and formatting
• Command bar custom formatter behavior: Any command configured with the following attributes will now appear in a distinguished area on the far right (or far left for right-to-left locales) of the command bar:
  • "primary": true
  • "position": 0
  Full details are documented here: View command bar formatting documentation
• No impact to other customizations: Other than the command bar custom formatter behavior described above, this change will not affect existing customizations made through SPFX, column formatting, or view formatting.

What you can do to prepare:

• No action is required to prepare for this change.
• If you use custom command bar formatters, review the updated placement behavior: View command bar formatting documentation.
• Before rollout, we will update this post with new documentation.

Compliance considerations:

No compliance considerations identified, review as appropriate for your organization.