Import a Word Document into Confluence

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. 

(warning) The Office Connector is only available for some browsers, operating systems and applications, so you'll need to check the Office Connector Prerequisites before you start.

On this page:

Related pages:


Import a Word document

  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 do not 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. 

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport