Importing a Word Document into Confluence

The Office Connector in Confluence allows you to import a Word document into Confluence, so that the document's content is copied onto one or more Confluence pages.

This is just one of the ways Confluence can interact with Office documents. For an overview of all Office Connector features, please refer to Working with the Office Connector.

(info) Your System Administrator can enable or disable the Office Connector or parts of it. The Office Connector options can appear in different places on your Confluence page, depending on the themes and configuration of your Confluence site. Please refer to Configuring the Office Connector in the Confluence Administration Guide and discuss any configuration problems with your administrator.

The simplest way to import a Word document is to import the entire content of the document into a single wiki page. By default, the content of the document will be created as a new wiki page.

More advanced options allow you to import the content into a new page, to split a single document into more than one wiki page, and to resolve conflicts in the titles of your pages.

These options are described below.

Prerequisites

Prerequisites for the Office Connector's document import feature:

  • Document import can import Microsoft Word documents of the file types .doc and .docx. These must be valid Word 97-2013 format documents.

For a full list of Office Connector prerequisites and limitations, please refer to:

Importing a Word Document

The simplest way to import a Word document is to import the entire content of the document into a single wiki page.

This method will replace any existing content on the wiki page.

To import a Word document onto a single wiki page:

  1. Create a page in Confluence (see Creating Content) or go to an existing page whose content you want replaced. View the page in view mode (not edit mode).
  2. Choose Tools > Import Word Document.

  3. Click Browse and find the Word document on your local drive or network.
  4. Click the Open or Upload button provided by your browser. The path and file name of the document will now appear in the text box on the Office Connector import screen.
  5. Click Next on the Office Connector import screen. The import document options screen will display.
  6. The import document options are:

    Option

    Description

    Root page title

    The title of the wiki page that will contain the information from your imported document.

    Import as a new page in the current space

    A new wiki page will be created with the page title specified above.

    Replace <pagename>

    The contents of the existing page will be replaced. The page will be renamed to the page title specified above.

    Delete existing children of <pagename>

    The existing child pages of the page you are replacing will be deleted.

    Rename imported pages if page name already exists

    Assign new names to any new page which would otherwise have a duplicate name. The content of existing pages will remain unchanged.

    Replace existing pages with imported pages of the same title

    If imported pages have titles equal to existing pages, then the content of the Word document will overwrite the content on the existing page. Page history will be preserved.

    Remove existing pages with the same title as imported pages

    If imported pages have titles equal to existing pages, then the existing pages will be deleted. This will remove the page history as well as the content.

    Split by heading

    The content of the Word document will be split over multiple wiki pages. If you don't want to split your document into multiple wiki pages, leave the default Don't split option selected. For more information on splitting your document, please see below.

  7. Click Import.

When the upload has finished, the content of the Word document will have been transformed into Confluence page content. You can now view and edit this page in the usual way. There is no connection between the original Word document and this wiki page.

Screenshot: Empty page ready for import

Screenshot: Selecting Word document to import

Screenshot: Importing a Word document


Screenshot: Page after import

Splitting a Word Document into Multiple Wiki Pages

When importing a Word document, you can split a single document into more than one wiki page, based on the heading styles in the document.

By default, the page names will be the same as the heading text. This may result in a conflict, if a page already exists with the same title. You can instruct the importer how to handle such conflicts.

To import a Word document into multiple wiki pages:

  1. Import a Word document as described above. On the import document options screen, choose how to split your document in the 'Split by heading' field:
    • 'Split by heading' — If you want to split the content under each heading in your document into separate child pages, select the desired heading level to split by. A preview of the page hierarchy that will be created by the split will be displayed under 'Document Outline'. Each bullet point in the 'Document Outline' represents a new page after import into Confluence.
  2. Click 'Import' to import your document.
  3. When the upload has finished, the content of the Word document will have been transformed into Confluence page content. You can now view and edit this page in the usual way. There is no connection between the original Word document and this wiki page.


Screenshot: Splitting a single Word document into multiple wiki pages

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