Guides

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.

Eric Dunaway
Eric Dunaway
Spaceli
6 min read

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

How Confluence features map to Google Drive and Spaceli
In ConfluenceIn Google DriveWith Spaceli on top
SpaceA folder in a shared driveA space
Page treeFolders and subfoldersThe sidebar
PageA Google DocA page with a table of contents
Info, note and warning panelsPlain textCallouts (Note, Tip, Warning, Danger, Success) written in Docs
Code block macroMonospaced textCode blocks with syntax highlighting
AttachmentsFiles in the same folderPDFs, Office files and images open inside the space
Embedded media and diagramsLinksYouTube, Loom, Figma, Miro and other embeds
Space permissionsFolder sharingSpace roles, reflected on the Drive folder
Page linksLinks between DocsLinks that open inside the space, down to a heading
LabelsNaming and foldersNaming 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.

Eric Dunaway
Written by Eric Dunaway

Writes about wikis, documentation and how teams keep their knowledge easy to find.

Share

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 Free

Free during the beta. Get started in about a minute.

Spaceli only accesses the folders you choose.