How to Stop OneNote Web Links from Opening the Desktop App
Question details
The user needs to prevent web links to OneNote pages from automatically launching the native OneNote desktop application.

- Product
- Microsoft OneNote
- Device & OS
- Windows 10
- Scenario
- Clicking a link to another OneNote page while browsing the web or using a web-based notebook interface.
- Observed behavior
- The browser detects the link and forces the native OneNote desktop application to open instead of navigating to the destination page within the browser window.
Ensure your web browser is fully up to date and check if any third-party extensions are modifying how your browser handles application links.
Modify Browser Protocol Handler Settings
Change your browser settings to stop allowing the OneNote protocol from automatically launching the desktop client.
Modern web browsers use protocol handlers to determine which local application to open when a specific link type is clicked. Disabling or clearing the handler for OneNote will force the link to stay in the browser.
Launch your primary web browser (e.g., Google Chrome or Microsoft Edge) and click the three-dot menu icon in the top right to access 'Settings'.
Go to 'Privacy and security' (or similar phrasing depending on the browser) and select 'Site Settings' or 'Cookies and site permissions'.
Expand the 'Additional permissions' menu and click on 'Protocol handlers' or 'Application links'.
Find 'onenote' or 'onenote-cmd' in the list of allowed protocols. Click the block button or remove the permission so the browser stops routing these links to the desktop app.

Repair the OneNote Installation in Windows
If adjusting settings does not fix the issue, your application file associations may be corrupted. Running a repair can restore default behaviors.
Looking for a Hassle-Free Office Suite Alternative?
If aggressive desktop app integrations are interrupting your workflow, consider switching to WPS Office. It provides a lightweight, flexible environment for all your document, spreadsheet, and presentation needs without forcing unwanted app behaviors.

Frequently Asked Questions
Why do OneNote links always open the desktop app by default?
Microsoft integrates its web applications deeply with native Windows apps using custom URL protocol handlers. When your browser detects a 'onenote:' link, it automatically hands it off to the installed desktop client to provide a richer editing experience.
Will repairing OneNote delete my notebooks?
No. Repairing the OneNote application through Windows Settings only fixes application files, registry entries, and link associations. Your actual notebooks are synced to your Microsoft account or saved separately on your drive.
Can I prevent links from opening desktop apps on a Mac?
Yes. On macOS, this behavior is controlled by your browser. If you previously allowed Safari or Chrome to open links in the OneNote application, you will need to clear your browser's site preferences or reset the prompt warnings for external app launches.




