Import a Word Document into Confluence

Import Content Into Confluence

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

The Office Connector allows you to import Word documents and create one or more Confluence pages from the content. 

You can create a single page, or divide the contents up into multiple pages, based on the headings in your document. 

This is useful if you have a lot of content stored in existing documents, or if you are migrating from another system or platform that allows you to export to Word format.

On this page:

Related pages:

Import a Word document

To import a Word document in Confluence:

  1. Create a page in Confluence or go to an existing page (you want to view the page, not edit it).
  2. Choose   > Import Word Document
  3. Choose Browse and locate the Word document you want to import, then choose Next.
    The import document options appear.  
  4. Enter a title for the new page (useful if you don't want to use the file name as your page title).
  5. Choose where you want to import the file (as a brand new page, or overwriting an existing page with the same title).
  6. Choose how to handle title  conflicts (rename the new pages or replace existing pages).
  7. Choose whether to create a single page or multiple pages based on the heading styles in the file (this option is only available if the file contains heading styles).
  8. Click Import.

When the upload has finished, pages will be created with the content of the Word documents. You can then view and edit this page as normal. There's no connection between the original Word document and this page.

Import options

There are a number of options when importing a Word document that control how pages are created, whether the import should overwrite existing pages in the space, and how it should handle page name conflicts.



Root page title

This is the title of the page that will be created or updated by the import.

Where to import

Controls whether the document is imported into the current page (the page you were viewing when you selected Tools > Import) or created as a new page. Choose from

  • Import as a new page in the current space - a new page will be created as a child of the space home page.
  • Replace <page name> - content will be imported into the current page. The title of this page will change to the title you specified in the Root page title field.
  • Delete existing children of <pagename> - any existing children of the current page will be removed when the content of the page is replaced.

Title conflicts

Controls how page name conflicts (a page with the same title already exists in the space) are handled.

  • Rename imported pages if page name already exists - new pages get a new name (a number added to the end of the page title). Existing pages will be unchanged.
  • Replace existing pages with imported pages of the same title - overwrite the content of existing pages. The change will be shown in the Page History for the page.
  • Remove existing pages with the same title as imported pages - remove original pages and then create new pages. The change is not shown in the Page History for the page.

Split by heading

If the document contains Word heading styles you can choose to create multiple pages based on the heading. Options are:

  • Don't split - creates a single page.
  • Level Headings - creates multiple pages in a hierarchy based on the heading levels in the document.

A preview of the pages that will be created appears under Document Outline.

Screenshot: Import Word options for a document that contains multiple heading levels. 

Supported file types

Confluence can import the content from Microsoft Word 97-2013 documents (.doc and .docx).

Importing documents containing wiki markup

If your document contains characters that are the same as Confluence Wiki Markup (for example square brackets, hashes etc) these characters may be automatically converted to their wiki markup value when you import your document, or wrapped in a wiki markup macro to preserve the formatting.


In order to prevent out of memory errors, we limit the uncompressed size of the file you can import to 20 MB. 

Your administrator can change this limit using the confluence.word.import.maxsize system property. 

Last modified on May 20, 2022

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.