Microsoft SharePoint Embedded: Update to driveItem.webUrl behavior
Microsoft is updating SharePoint Embedded’s driveItem.webUrl to return browser launch URLs instead of stable file locations. Use driveItemId for stable identifiers. Changes roll out from mid-August 2026, with a temporary opt-out until February 22, 2027. Review and update applications accordingly. What and why We are updating the behavior of the Microsoft Graph driveItem.webUrl property for content stored in SharePoint Embedded. After this change, driveItem.webUrl will return the URL used to open a file in a browser rather than being treated as a stable file location or identifier. Depending on the file type and your SharePoint Embedded configuration, the returned URL may be: A Microsoft 365 web viewer URL A SharePoint Embedded PDF viewer URL A redirect URL generated from your configured urlTemplate A Microsoft help page URL This update aligns driveItem.webUrl with its intended purpose as a browser launch URL. Applications that require a stable identifier for a file should use driveItemId, which remains the only unique and stable identifier for an item within a drive. The SharePoint Embedded documentation describes driveItem.webUrl as the URL used to launch supported files in Microsoft 365 experiences. Rollout schedule Targeted Release: Beginning in mid-August 2026 General Availability (Worldwide): Beginning in mid-February 2027 Temporary opt-out available until: August 17, 2026 Customers who opt out before August 17, 2026, will have an additional six months to transition to the new behavior. Temporary opt-out support ends February 22, 2027 After February 22, 2027, all customers will receive the updated driveItem.webUrl behavior. Impact on your organization Who is affected Organizations that develop, manage, or use SharePoint Embedded applications that rely on driveItem.webUrl as a permanent file location, stable URL, or file identifier Platforms and services SharePoint Embedded Microsoft Graph Microsoft 365 web viewers SharePoint Embedded PDF viewer What will happen After this change: Word, Excel, PowerPoint, and other supported Microsoft 365 file types will return a Microsoft 365 viewer URL. PDF files will return a SharePoint Embedded PDF viewer URL. Unsupported file types with a configured urlTemplate will return a redirect URL generated from that template. Unsupported file types without a configured urlTemplate will return a Microsoft […]
The post Microsoft SharePoint Embedded: Update to driveItem.webUrl behavior appeared first on M365 Admin.
Published on:
Learn moreWe can help you with Microsoft SharePoint Embedded: Update to driveItem.webUrl behavior
If you want help implementing, troubleshooting, or improving this product, contact us and we’ll point you in the right direction.
Related posts
Copilot Studio – Create Dataverse agent users with Microsoft Entra agent ‘s user account
We are announcing the ability to create Dataverse agent users with Microsoft Entra agent’s user account in Copilot Studio. This feature ...
Low-latency alerts and metrics in Monitor
We are announcing the ability to evaluate alert rules and review supported metrics for business-critical resources every hour in Monitor, help...
Enhanced prompt categories for Microsoft 365 Copilot in Microsoft Copilot Dashboard and Agent 365 Business Analytics
Microsoft 365 Copilot introduces 13 enhanced prompt categories replacing four legacy ones in the Copilot Dashboard and Agent 365 Business Anal...
Microsoft Teams mobile: Updated app bar and More menu on iOS and iPadOS
Microsoft Teams for iOS/iPadOS will update the app bar and More menu to align with iOS 26 design, showing four apps plus a categorized More me...
Microsoft Copilot: GPT-6.2 Sol and Astra rolling out
Microsoft Copilot is expanding AI model options with GPT-6.2 Sol and Astra, rolling out across Cowork, Copilot Studio, Word, Excel, PowerPoint...
Power Platform Monitor – Route alert notifications to connector-backed destinations
We are announcing the ability to route Power Platform Monitor alert notifications to Microsoft Teams, SMS, work item tracking systems, and oth...
Updates to Workforce Insights Agent (Frontier) for Admins in Microsoft 365 Copilot
Microsoft 365 Copilot’s Workforce Insights Agent (Frontier) adds a workspace for admins to configure organizational data and context, im...
Microsoft Teams: Tenant policy controls who can record and transcribe
Microsoft Teams will introduce a tenant policy controlling who can record and transcribe meetings, allowing admins to set permissions for orga...
Microsoft Copilot: In-app browsing will be enabled by default in the desktop app
Microsoft Copilot desktop app will enable in-app browsing by default starting January 2027, allowing users to open websites shared in chat wit...
Copilot video creation in Clipchamp Video Hub is now live in Frontier Public
Copilot video creation in Clipchamp Video Hub is now in public preview, enabling users to create and refine videos from documents and prompts ...