How to Fix Broken OneDrive File Links in OneNote for Mac
Question details
Users experience broken file links when attempting to upload files to a personal OneDrive account and insert them as links within OneNote for Mac.
- Product
- OneNote for Mac, OneDrive
- Device & OS
- Mac
- Scenario
- Using the 'Upload to OneDrive and insert link' feature in OneNote for Mac connected to a personal Microsoft account.
- Observed behavior
- The automatically generated links are broken and fail to open across all platforms, including Safari, Firefox, OneNote for the web, and Windows devices.
Verify whether your notebook is stored on a personal OneDrive account or OneDrive for Business, as this specific link generation bug primarily affects personal accounts.
Manually Upload Files to OneDrive and Insert Links
Since the automatic upload feature creates broken links on personal accounts, bypassing it by manually generating a sharing link from OneDrive is the most reliable workaround.
Microsoft has confirmed that the 'Upload to OneDrive and insert link' process has a bug affecting personal OneDrive servers. Until a server-side fix is deployed, you must handle the file upload and link generation separately.
Launch your preferred web browser, navigate to the OneDrive website, and sign in with your personal Microsoft account.
Drag and drop the file you wish to share into your OneDrive files list, or use the 'Upload' button at the top of the screen.
Right-click the newly uploaded file and select 'Share' or 'Copy link'. Ensure the sharing permissions are set correctly.
Open OneNote for Mac, navigate to your notebook page, and paste the copied link directly into your notes.
Report the Issue to Microsoft Support
Because this is a recognized bug involving personal OneDrive servers, submitting feedback from your Mac helps Microsoft prioritize a permanent backend fix.
Switch to WPS Office for Reliable Document Management
If you are frustrated by broken links and syncing bugs in OneNote, consider switching to WPS Office. It provides a lightweight, highly compatible suite for managing your documents, with built-in cloud storage that makes cross-platform file sharing fast and reliable.
- 1. Download WPS Office: Visit the official WPS website to download and install the free office suite for Mac.
- 2. Sign In for Cloud Space: Create a free account to activate your built-in WPS Cloud storage.
- 3. Share Files Reliably: Upload your documents and generate stable sharing links that work seamlessly on any browser or operating system.
Frequently Asked Questions
Why do file links work in OneDrive for Business but not personal OneDrive?
Microsoft has identified a server-side bug specific to personal OneDrive accounts when generating links via OneNote for Mac. OneDrive for Business operates on a different backend infrastructure (SharePoint), which successfully processes these link requests.
Will the broken OneDrive links in OneNote fix themselves automatically?
Once Microsoft implements a server-side fix for personal OneDrive accounts, newly generated links will work. However, any previously inserted links that are currently broken will likely need to be replaced manually.
Does this broken link issue affect OneNote on Windows?
While the bug originates when creating the link using the Mac version of OneNote, the resulting broken link will fail to open on all platforms. This includes Windows devices, Safari, Firefox, and OneNote for the web.
Can I use iCloud or Google Drive instead of OneDrive for OneNote attachments?
OneNote's native 'Upload and insert link' feature is exclusively tied to Microsoft OneDrive. To use other cloud services like iCloud or Google Drive, you must manually upload the file to those services first and then paste the shareable link into your OneNote page.
