How to Migrate Confluence HTML Content to SharePoint Online
Question details
The user needs a method to import an exported Confluence space (HTML and CSS files) into SharePoint Online without purchasing expensive third-party migration tools.
- Product
- SharePoint Online
- Device & OS
- not provided
- Scenario
- Migrating a company wiki or team documentation from Atlassian Confluence into modern Microsoft SharePoint Online pages.
- Observed behavior
- There is no straightforward native import function in SharePoint Online to convert a folder structure of HTML and CSS files into fully functional SharePoint pages.
Ensure you have Site Owner or Administrator permissions in your SharePoint Online environment and have unzipped the Confluence HTML, CSS, and image files to a local directory for easy access.
Recreate Content Manually as Modern SharePoint Pages
Best for smaller Confluence spaces or specific high-priority pages, ensuring that all formatting is natively supported by SharePoint.
Since SharePoint Online restricts raw HTML and CSS uploads for security and design consistency, manually copying the content into modern pages is the most reliable method for small-scale migrations.
Navigate to your SharePoint Online site, click on 'New' in the top menu, and select 'Site Page' to create a blank template.
Locate your extracted Confluence export folder on your computer and open the specific HTML files using your standard web browser.
Highlight the text, tables, and lists in your browser, copy them, and paste them directly into the Text web part of your new SharePoint page.
Manually upload the corresponding images from your local Confluence export folder to the SharePoint Site Assets library and insert them into your page using the Image web part.
Use SharePoint's native rich text editor to adjust headings and styles, then click 'Publish' to make the page live.
Develop a Custom PowerShell Migration Script
Ideal for users with development experience handling large volumes of Confluence HTML pages.
Consult the Microsoft Q&A Community
If you lack development resources, consulting Microsoft engineers and community members can reveal up-to-date scripts or alternative workarounds.
Manage Your Team Documentation Easily with WPS Office
While migrating complex wikis to SharePoint can be a tedious process, managing your daily team documents shouldn't be. WPS Office is a free, lightweight alternative to Microsoft Office that lets your team easily create, edit, and share Word documents, Excel spreadsheets, and PDFs without the hefty subscription fees.
- 1. Download the Installer: Visit the official WPS Office website to download the free installation package for your operating system.
- 2. Install the Suite: Run the installer and follow the simple on-screen instructions to set up the software in minutes.
- 3. Manage Team Documents: Open your exported PDFs or create new Word documents to efficiently manage your team's knowledge base.
Frequently Asked Questions
Can I directly upload Confluence HTML files to create native SharePoint pages?
No. SharePoint Online does not support converting raw HTML files directly into functional modern site pages. You must either manually copy the text into the rich text web part or use a script/third-party tool to map the data programmatically.
Is there a free Microsoft tool to migrate Confluence to SharePoint?
Currently, Microsoft does not provide a native, free tool specifically designed to import Confluence HTML or XML exports into SharePoint Online pages. Most automated, point-and-click solutions require paid third-party software.
What should I do with my exported Confluence PDF files?
If you exported your Confluence space as PDF documents instead of HTML, you can directly upload these files into a SharePoint Document Library. They will be searchable and easily viewable by your team without needing page reconstruction.
