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
Microsoft Entra ID: Risk-based anti-bot verification (CAPTCHA) for SMS and voice multi-factor authentication
Starting mid-November 2026, Microsoft Entra ID will add risk-based CAPTCHA verification for SMS and voice MFA to prevent automated fraud. Some...
[Outlook for iOS and Android] Copilot Chat in Outlook UX improvements
Copilot Chat in Outlook for iOS and Android is being updated with a refreshed, consistent design across Microsoft 365 apps, improved chat inte...
Microsoft Word: Retirement of legacy compatibility settings
Microsoft Word will retire legacy compatibility settings for documents in Compatibility Mode starting December 2026 (Windows) and early 2027 (...
Power Platform – Information regarding the end of support for SharePoint temporary authentication URLs
Starting April 1, 2027, SharePoint temporary authentication URLs will be retired. Power Apps and Automate functionality that relies on these U...
Windows Office Hours: November 19, 2026
If you are an IT admin with questions about managing and updating Windows, we want to help. Every third Thursday of the month, we host a live ...
Scheduled prompts in Microsoft 365 Copilot are moving to native Copilot scheduling and the Tasks view
Microsoft 365 Copilot is moving scheduled prompts from Power Platform to native Copilot scheduling, enabling automatic execution of one-time o...
Prevent issues with NetApp SMB shares: Learn about new Windows Server security requirements
Microsoft introduced additional security requirements for LDAP authentication on Active Directory domain controllers starting with the October...
60-day reminder: Hardening changes for ReFS volumes on removable media
Microsoft is making hardening changes to the Resilient File System (ReFS). The changes improve the security posture of Windows by adding visib...
Microsoft 365 Copilot: Copilot Workspaces is replacing standalone agent selection with agentic chat
Microsoft 365 Copilot Workspaces will replace standalone agent selection (Researcher, Analyst, Designer) with an agentic chat that applies ski...
Microsoft Teams: Updated recording and transcript access setting behavior for town halls and webinars
Microsoft Teams is updating the “Who has access to the recording or transcript” option for Events App town halls and webinars. It ...