How to Migrate from Confluence to Google Docs
What maps to what, how to export and convert your spaces, and the pitfalls to avoid, so your team keeps the structure it had in Confluence.

Moving from Confluence to Google Docs takes five moves: decide what's worth keeping, rebuild the space structure as Drive folders, export the pages, convert them to Google Docs and fix what conversion breaks. A small space takes an afternoon; a large one a few weeks. At the end, connect the folders to a wiki layer so your team keeps the sidebar, search and reading view they had in Confluence.
With Confluence Data Center reaching end of life on March 28, 2029, many self-hosted teams are making this move now (Atlassian). Still choosing where to go? See the best Confluence alternatives for Google Workspace teams.
What maps to what
| In Confluence | In Google Drive | With Spaceli on top |
|---|---|---|
| Space | A folder in a shared drive | A space |
| Page tree | Folders and subfolders | The sidebar |
| Page | A Google Doc | A page with a table of contents |
| Info, note and warning panels | Plain text | Callouts (Note, Tip, Warning, Danger, Success) written in Docs |
| Code block macro | Monospaced text | Code blocks with syntax highlighting |
| Attachments | Files in the same folder | PDFs, Office files and images open inside the space |
| Embedded media and diagrams | Links | YouTube, Loom, Figma, Miro and other embeds |
| Space permissions | Folder sharing | Space roles, reflected on the Drive folder |
| Page links | Links between Docs | Links that open inside the space, down to a heading |
| Labels | Naming and folders | Naming and folders |
Not everything has a twin. Jira issue macros, page properties reports and other dynamic macros become plain links or static tables after the move.
Step by step
1. Take inventory and decide what to keep
List your spaces and their most-viewed pages. Most Confluence instances carry years of pages nobody opens. Move only what people still use; export the rest as an archive and leave it there. This step usually cuts the work in half.
2. Rebuild the structure in Google Drive
Create a shared drive (or a folder) per space and a folder per top-level branch of the page tree. Keep it to two or three levels. Assign an owner to each folder, the same person who owned the space. Our Google Drive folder structure templates give you a starting point.
3. Export from Confluence
Confluence can export a space to HTML, PDF or XML, and single pages to Word. For a space, the HTML export creates one HTML file per page in a zipped archive (Atlassian). Prefer HTML over Word for a Google Docs migration: Atlassian notes that the Word export can only be opened in Microsoft Word and isn't compatible with Google Docs, and it includes only the first 50 images of a page.
4. Convert pages to Google Docs
Upload the exported HTML files to the matching Drive folders and open each one as a Google Doc, or turn on converting uploads in Drive's settings. For your most important pages, copying the content from Confluence and pasting it into a new Doc often gives the cleanest result.
5. Fix what conversion breaks
Check headings (re-apply real heading styles so the table of contents works), tables, images and code. Recreate info panels as callouts and code macros as code blocks. Replace links to Confluence pages with links to the new Docs, and turn dynamic macros into links.
6. Connect the folders to Spaceli
Create a space from each folder in Spaceli. The folders become the sidebar, every Doc a page with a table of contents, and Cmd+K searches titles and full text. Spaceli offers to invite everyone who already has access to the folder in Drive, with roles carried over, and colleagues on your domain can join on their own.
7. Switch over
Announce the date, pin the new spaces in your team chat, and make the old Confluence spaces read-only. Keep them available for a few months so old links still resolve, then archive them.
Common pitfalls
- Moving everything. Old pages migrated as they are make the new home as cluttered as the old one. Archive generously.
- Bold text instead of headings. Converted pages often lose heading styles. Without them, there's no table of contents and no links to sections.
- Broken internal links. Links still pointing to Confluence stop working when it goes read-only. Search each Doc for your Confluence domain before you switch.
- Permissions copied too literally. Confluence page restrictions don't map one to one. Use folder-level access and keep exceptions rare.
- No owners after the move. Name an owner per folder on day one, or the new knowledge base decays like the old one.
- A long parallel period. If both systems stay editable, people keep writing in the old one. Pick a date and make Confluence read-only.
FAQ
How long does a Confluence to Google Docs migration take?
A space with a few dozen pages takes an afternoon. A company with many spaces and years of content should plan a few weeks, mostly for deciding what to keep and fixing formatting.
Can I keep Confluence's page tree?
Yes. Rebuild it as folders in Google Drive. With Spaceli, that folder tree becomes the sidebar, so readers browse it the way they did in Confluence.
What happens to page comments?
Comments don't carry over in exports. Resolve open discussions before you migrate, or copy the important ones into the page.
Do we lose search?
Drive search covers all your files. Spaceli adds search across a space only, with titles found instantly and the full text of every doc.
What does it cost?
Google Docs is part of Google Workspace. Try Spaceli free for 30 days; after that, plans are priced by team size, from $19 a month for up to 10 users, instead of per user.
Sources
Checked September 15, 2026.

Writes about wikis, documentation and how teams keep their knowledge easy to find.
Keep reading
All articles →How to Create a Wiki in Google Docs (Step by Step + Free Template)
Build a team wiki in Google Docs step by step: folder structure, home page, headings, links and permissions. Free template plus a faster way to do it.
How to Build a Public Help Center from Google Docs
Turn a Google Drive folder into a public help center customers can read without signing in. Plan it, write it in Google Docs and keep it current.
Google Drive Folder Structure for Teams: A Template That Scales
A Google Drive folder structure that scales: five rules plus copy-ready templates for startups, agencies and engineering teams.
Your knowledge base is already in Google Drive.
Give your team a better way to organize, find, and share knowledge. Keep your documents right where they are.
Start for FreeFree during the beta. Get started in about a minute.
Spaceli only accesses the folders you choose.