How to Embed a OneNote Page from OneDrive for Business on a Website
Question details
The user wants to embed specific content from a OneDrive for Business OneNote page onto a website without the native header and navigation panes, but encounters a conversion error when using an exported .one file.

- Product
- Microsoft OneNote / OneDrive for Business
- Device & OS
- not provided
- Scenario
- Publishing notebook content to a website cleanly by stripping away the default OneNote interface elements.
- Observed behavior
- Attempting to embed a locally exported .one file directly results in a format conversion error, as the standalone file lacks the full notebook structure required by the web renderer.
Verify that your website supports iframe embedding and that you have the necessary sharing permissions enabled in your OneDrive for Business administrator settings.
Use Official OneDrive Web Sharing for Embedding
Generate an official embed link directly from the cloud version of OneNote rather than uploading a local .one file.
A local .one file cannot be embedded directly as a standalone webpage. It functions only as a structural part of a local OneNote notebook. Cloud-based OneDrive notebooks and local notebooks use incompatible formats for direct web rendering.
To embed a page successfully, you must use the built-in sharing features of OneNote for the Web, ensuring the notebook is properly synced to the cloud.
Log into your OneDrive for Business account via your web browser and navigate to the synced OneNote Notebook.
Click on the notebook to open it in the OneNote for the Web interface.
Navigate to the specific page, click 'File' > 'Share' > 'Embed'. Copy the provided iframe code.
Paste the iframe code into your website's HTML. Note that this official method may still display some minimal UI elements depending on Microsoft's current iframe parameters.

Export Page as PDF for a Clean Web Embed
Export the OneNote page to a web-friendly PDF format to completely eliminate headers, footers, and navigation panes.
Publish and Embed Documents Easily with WPS Office
Avoid cloud syncing errors and proprietary format restrictions when embedding content online. WPS Office is a highly compatible, lightweight alternative to Microsoft Office that lets you effortlessly format and export documents to web-ready PDFs for clean, header-free website embedding.
- 1. Open Your Content: Launch WPS Office and paste your notes or document content into a new Writer file.
- 2. Format for Web: Adjust the page layout and margins to suit how you want it to appear on your website.
- 3. Export to PDF: Go to 'Menu' and click 'Export to PDF'. Upload this PDF to your site for a perfectly clean iframe embed.

Frequently Asked Questions
Why do I get a conversion error when uploading a .one file to my website?
A .one file is not a standalone web document; it is a structural data file that relies on a complete local OneNote notebook hierarchy. Web browsers and OneDrive's web renderer cannot read isolated .one files, leading to conversion errors.
Can I completely hide the OneNote navigation pane in an iframe?
Currently, Microsoft does not provide an official URL parameter to completely strip away all headers and navigation panes in a live OneDrive for Business OneNote embed. Exporting the content to a PDF or HTML file is required for a 100% clean embed.
Are OneDrive and local OneNote notebook formats different?
Yes. Local notebooks are saved as a collection of .one and .onetoc2 files on your hard drive, whereas OneDrive notebooks use a specialized cloud-synced format that is not accessible as individual file components.




