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.

Option

Description

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!

70 Archived comments

  1. User avatar

    TroyGrosfield

    Are there any APIs associated with the doc importer?  We are trying to move all of our documentation out of word docs and into confluence, but a manual process would take way to long.  Is there a programatic way to handle the content migration?

    30 Mar 2009
    1. User avatar

      Azwandi Aris [Atlassian]

      I am sorry that I can't think of any workaround, but I am pretty sure that you are not alone. Please add your comments in the request to truly reflect your requirements. Hope that helps!

      31 Mar 2009
  2. User avatar

    Anonymous

    Do you know when you will be providing support for .docx and well as docs that are created using Office for Mac as you still cannot save it as a .doc file on the Mac and have it be able to import. You get the same error as you do when you import a .docx.   It would be very helpful, given the number of that are now 2007 or are Mac, to be able to utilize this feature.

    17 Apr 2009
    1. User avatar

      Giles Gaskell

      Hello there,

      At Atlassian, we usually implement new features based on their level of popularity (i.e. the number of votes which have been cast on a feature request on our JIRA site). Feature requests with more votes often have a greater chance of being implemented than those with fewer votes.

      We currently have a feature request on our JIRA site for Office 2007 file format support. Please feel free to cast your vote on it to improve its chances of being implemented.

      Best regards,

      Giles Gaskell
      Technical Writer
      ggaskell@atlassian.com
      ATLASSIAN - http://www.atlassian.com

      23 Jun 2009
  3. User avatar

    Anonymous

    The page introduction say "import an Office document" but further down the page it says "can import documents of the file type .doc. These must be valid binary Word 97-2003 documents".

    There are a lot of office documents that aren't word documents. Are there plans to expand the range of documents that can be imported?

    09 Jun 2009
    1. User avatar

      Azwandi Aris [Atlassian]

      There is a similar request in regards to this issue:

      As far as I am concerned, there is no work being done to incorporate this feature into Confluence at the moment, however, your vote and comments may increase the chances for it to be implemented (smile)

      Cheers,
      Azwandi

      15 Jun 2009
  4. User avatar

    Ben Aveling

    Is there any workaround for the following:

    1. When importing, if you split to multiple pages, it doesn't seem to link from the parent page to the newly created child pages.  It has them marked as child pages, but the ordering is lost - they become sorted alphabetically, rather than in the order they should be.
    2. When exporting, it just exports the parent page - it doesn't have an option to export the child pages. http://jira.atlassian.com/browse/CONF-8740
    3. How to bulk import?
    15 Jun 2009
    1. User avatar

      Ben Aveling

      You can use the children macro as a workaround for my point #1 above, if you use sort=creation.  It's a bit of a kludge, but it seems to work...

      Eg {children:sort=creation}

      15 Jun 2009
      1. User avatar

        Ben Aveling

        And if the word document has a TOC before the first Heading, that gets turned into a bunch of links - the formatting is stunningly ugly - no indenting of subheadings, too much use of bold - but it might be a workaround for some people.

        15 Jun 2009
      1. User avatar

        Gina Wadley

        The children display macro was very helpful.  But if you sort by creation, it doesn't automatically change the order of your table of contents (we're using the Documentation theme).  So you have to browse pages, then drag the titles around in the tree view.  This is definitely not efficient when you've imported 100 pages.  Does anyone have a better way to do this?  I've requested this in the Confluence item tracker:  Import Adobe RoboHelp and Madcap Flare files http://jira.atlassian.com/browse/CONF-18210

        11 Jan 2010
    1. User avatar

      Ben Aveling

      15 Jun 2009
  5. User avatar

    Ben Aveling

    It seems to fail for large documents - with no explanation of why... (Where 'large' is perhaps approx 10M)

    Question: how to tell what the maximum import size is? Can it be increased? How?

    15 Jun 2009
    1. User avatar

      Ben Aveling

      Large is indeed 10M. This is configurable, in Dashboard -> Administration -> General Configuration. I did a test update of 30M (and yes, if we proceed, we will have doc files this big) and it seems to have worked when split to child pages. Uploading 15M as a single page failed, not that we'd actually want to do that.

      So that's good. But not good that too-large uploads just get a silent fail with no explanation of what has gone wrong.

      16 Jun 2009
      1. User avatar

        Azwandi Aris [Atlassian]

        Hi Ben,

        In case this problem remains unresolved, feel free to raise a support ticket.

        Cheers,
        Azwandi

        12 Aug 2009
  6. User avatar

    Anonymous

    I've imported a Word doc using the defaults (single page) but would like to divide that page into several pages after import (at the Heading 1 level). Is there there a way to easily do this without manually creating child pages and copying content into them? I've searched and can't figure out how to do this. I'm using the evaluation edition (3.0) and have admin access. Thanks. Like what I'm seeing so far.

    19 Jun 2009
    1. User avatar

      Ben Aveling

      Is it an option to re-import it using the advanced options, and this time tell it to split it into child pages?

      19 Jun 2009
      1. User avatar

        Zed Yap [Atlassian]

        Hi,

        Is it an option to re-import it using the advanced options, and this time tell it to split it into child pages?

        Yes, Ben you are right. You will be able to Split an Office Document into Multiple Wiki Pages based on the heading styles in the document. Please refer to this documentation:

        Hope that I did not misinterpreted your question.

        Best rgds,
        Zed

        02 Jul 2009
        1. User avatar

          Anonymous

          Hi, We also want to start using Confluence for our technical writing so need to import all our current Word documents. You said that you can create individual pages (which I would like to do) by the Word Heading. However, the Word template we're using doesn't use Headings per se, but rather has mapped them to MT1, MT2, MT3 etc. Does that matter or should it still work?

          Thanks, Esther

          18 Oct 2009
  7. User avatar

    Mark Salamon

    I am simply having too many problems with this plugin:

    • When I try to create as a new page, I get a Page Not Found error.  Why not just set the default to create a new page, which makes more sense.
    • I tried importing a document but there were no line breaks shown at all. Everything was condensed into one big paragraph.
    • My document had "headings" but not using the headings styles but just with text that was underlined, so I could not break into multiple pages. Perhaps give ppl the option of selecting where to break up a page and what headings to use in the TOC, even if  you don't detect headings.
    • Will you provide the ability to import PDF files?  I have already voted in favor of Word 2007 files.
    22 Jul 2009
  8. User avatar

    Gina Wadley

    Make sure to remove the index of any Word docs before you import them.  If not I'm getting a system error:  java.lang.IndexOutOfBoundsException: Index: 15, Size: 15
        at java.util.ArrayList.RangeCheck(ArrayList.java:547)

    11 Jan 2010
    1. User avatar

      Anonymous

      To do this, you cannot simply go to the end of the document and delete the index.  You must 'Show paragraph marks' in Microsoft Word and find and delete all of the index tags.  They will look similiar to this:

      {xe.} plus some text that you indexed.  You must delete that line and save your document.  Then try to import it again.

      03 Nov 2011
  9. User avatar

    Gina Wadley

    How do you preserve hyperlinks in a Word document after it's been imported?  I generated a 200 page Word doc from RoboHelp 7, then imported it into Confluence (split into different pages by the 6 headings).  However, the internal hyperlinks don't work (the external links are fine).  Is there a way to preserve the hyperlinks?

    11 Jan 2010
    1. User avatar

      Jack Low [Atlassian]

      Hi Gina,
      Confluence supports hyperlink in a valid Ms Word 97-2007 document. I haven't tested any word document exported by RoboHelp 7, would you able to open the exported word document with Ms Word > Re-save doc into another document > attach it into Confluence to try again?

      Please note that there is a known bug in Confluence 3.0.x, in which we need to simply edit the hyperlink on the URL and click ok (no changes is required, only view the edit menu from word document > ok) this appears to reapply the link and the hyperlink is working now. This issue has been fixed in Confluence 3.1.

      I hope it helps. Please feel free to ask if you need further assistant.

      Thanks & regards,
      Jack

      23 Feb 2010
  10. User avatar

    Gina Wadley

    When you split a Word doc during the Doc Import process, the pages are imported in alphabetical order, not in the order of the document's headings.  When I used ePublisher to import the Word doc I had generated from RoboHelp 7, then exported from ePublisher to Confluence, ePublisher kept the page ordering.  I use Confluence's Documentation Theme and the left-hand navigation pane shows the page titles in the correct order. 

    Is Atlassian working on correcting the page ordering issue?

    Thanks.

    22 Mar 2010
    1. User avatar

      Anonymous

      Many users have posted comments on this page about the issue I am experiencing. When importing Word docs, Confluence rearranges the topics in alphabetical order, rather than the order in which the topics appear in the document.

      Atlassian, is it possible to vote for this feature?

      Thank you,
      CB

      31 Oct 2012
      1. User avatar

        Bill Arconati

        There is an open feature request for this CONF-16394 - Advanced Doc Import confused pagetree page hierarchy Open .

         

        09 Nov 2012
  11. User avatar

    Anonymous

    We're using 3.1.2 - and when I import a Word document that already has some wiki mark-up in it, the conversion seems to cancel the code:

    comes out on the page, then I have to go back into the page and take out the '/'.

    Does anyone know why this happens/hot to get around it?

    Thanks!

    AAP

    14 May 2010
    1. User avatar

      Husein Alatas [Atlassian]

      Hi AAP,

      This actually happens because Confluence is expecting all the text contents of Word document to be text-only, not a wiki-markup that contains macro. So Confluence will render all text content in word Document as normal text. Therefore it will insert escape character to any macros so that it will be shown as text in the page.

      But if you are keen on this, feel free to raise a feature request at http://jira.atlassian.com and describe in detail how you require this feature to work. For further details on how we include new features and improvements, you might want to read this page.

      Hope that clarifies (smile)

      Cheers,
      Husein

      17 May 2010
      1. User avatar

        Anonymous

        Thanks Husein,

        I think it would be helpful to be able to do this, in the case of adding in both the table of contents, and the 'code' macros.

        Especially the code/no format macros - as the support teams had to go in after the import and remove all the code that got marked up in the import, and 'copy/paste' it back in - and adding the code or noformat macro at that time.

        This is an issue for people who are converting/importing their documentation from word files into wiki pages.

        I'll look into adding the feature request.

        Thanks again for the response.

        Kind regards,

        AAP

        26 Aug 2010
      1. User avatar

        Lis Riba

        Is there any way to batch-edit imported pages? Find and Replace?

        I'm trying to import a glossary from Word (splitting pages) and requiring tags to be manually added to every page is not terribly appealing.

        19 Oct 2010
  12. User avatar

    Anonymous

    Hi,

    I imported a Word document and split it.

    Now I want to print it. Is there a way to show the split pages as a single page (like on the original document), so i can print it as a single file?

    16 Jun 2010
    1. User avatar

      Anonymous

      I used the 'Export to Word' function to open a few of them, and then cut and paste to put them back into one big Word file. There is also the 'Export to PDF' function that Administrators have. I wonder if you could select the pages you want, and then tell it to pdf them?

      Not sure. I know in the Export to HTML function, that you can select which pages to send.

      AAP 

      26 Aug 2010
  13. User avatar

    Jon Garfunkel

    Importing a document once is nice... but, consider that our Office documents tend to live on, and be updated in, an ECM server. Importing a document once could make it out-of-date.

    So it would be useful as well to store a URL to that document, and have Confluence download and render it dynamically.

    16 Nov 2010
  14. User avatar

    Alastair Bain

    Is there any way to control the generation of images when importing from a word document? We have a lot of documents with embedded visio diagrams, and the import creates images with very low resolution/size, the images are so small that they're not really usable. 

    17 Feb 2011
    1. User avatar

      Anonymous

      Same here! This renders the Word importer close to useless for us.

      09 May 2011
  15. User avatar

    Anonymous

    Is it possible to import a Word document and use a global Confluence template for the page formatting?

    16 Jun 2011
  16. User avatar

    S. Dineen

    So as  I import Word documents in, My old headers (and now page titles) are appended with numbers (0,1,2 over and over).

    Any ideas on this?

    22 Jun 2011
    1. User avatar

      Anonymous

      When you already have something else in confluence with the same title, it does not allow you to keep it the same so it add another number at the end. Something Atlassian needs to fix asap!

      31 May 2012
  17. User avatar

    nijingjie

    I imported a word document(MS word) like blow.

    -----------------------------------------------------------------------

    • ctitle
    • btitle
    • atitle

    -----------------------------------------------------------------------

    But the titles become

    atitle

    btitle

    ctitle

    after imported.

    How can I keep the same title's sort like "ctitle","btitle","atitle" as the word document when importing?

    29 Sep 2011
  18. User avatar

    Dan Milton

    Is there a way to specify which style to split the Word document on? When my documents are generated from another tool headings are assigned h1, h2, and h3. However, Confluence seems to be looking for Heading 1, Heading 2, and Heading 3. Can I tell Confluence to treat h1 as Heading 1?

    11 Jan 2012
    1. User avatar

      peter andersson

      We have the same problems, but our headings is named completely different.

      Can you map Heading 1 to something else?

      03 Oct 2012
  19. User avatar

    Kenric

    I have alot of of word documentation that has screen shots in them.

    But when I import the Word Doc into Confluence, none of the jpg screen shots are included.

    RIght now I am manually saving each screen shot and attaching them to the Confluence page, and then inserting them back into the right part of the document....

    Ids there a way of just import the document while preserving the jpg insert???

     

    something this simple should not be so hard

    18 Apr 2012
    1. User avatar

      Anonymous

      On a similar note the images within a .docx file that have Word Art (arrows, numbers, etc) overlayed on them load as black images after the import.  The screen shots, etc. all look fine except for those with the Word Art overlayed.

      19 Apr 2012
    1. User avatar

      Anonymous

      This worked for us just fine in 4.1.7, but for some reason it stopped working once we performed an upgrade to 4.2.1.

      Just to be safe that it isn't our installation we also performed a new install with 4.2.1, but it ended up with the same result. Office Connector can no longer import any screenshots (e.g. JPG).

      That's a real bummer for us...

      Does anybody have a solution?

       

      03 May 2012
      1. User avatar

        Anonymous

        I'm experiencing the same thing in Confluence in OnDemand.  I'm guessing this is a bug, since I agree that it used to work for me.  I'm testing with a docx from Mac Office 2011.

        23 May 2012
      1. User avatar

        Anonymous

        We are having the same issue. Any help would be greatly appreciated!

        We have some very large documents with a huge number of screenshots. Is there any way to get them to load automatically?

        07 Aug 2012
    1. User avatar

      Anonymous

      I encountered same problem but it could be fix if you convert docx into Word 97-2003 format

      31 May 2012
  20. User avatar

    Anonymous

    When I imported Word document into Confluence and used the split function, instead splitting it in the order of the document, Confluence decided to display it in alphabet order. Is there any way to fix it?

    31 May 2012
    1. User avatar

      Steven

      I also have this issue. Alphabetical order should not be the default order of a Word import!

       

      02 Jul 2012
  21. User avatar

    Sander Verschuren

    We are converting a lot of documents to wiki pages, so we're using the import from Word functionality a lot. The way we structure pages is as follows: We have 1 master page, that contains includes to the child pages generated by the importer. We do this mainly to limit the size of the individual confluence pages, to make concurrent edits possible, have a finer grained version history (per chapter in stead of per document). This way of working allows us to export the master page to pdf without the need to install a plugin that also exports child pages. Another added benefit is that we can easily add numbered headings, by placing the includes inside a numbered headings macro.

    Okay, that's our scenario. Now the question (wink)

    When importing from word and splitting by heading 1, the child pages will have as name the original heading from word. The pages however don't have a heading themselves. So when we look at the master page with the includes, all heading 1 are missing.

    Is there an easy way around this? Or do we have to manually put in all the headings in the child pages?

    Thanks!

    PS. Any feedback on our way of working is also very welcome

    29 Jun 2012
    1. User avatar

      Anonymous

      Same issues here, we are in a Confluence trial and I am going from Flare, to word, to Confluence. Just starting and looking to split pages by headings.

      19 Sep 2012
      1. User avatar

        Anonymous

        replacing heading styles through Word worked._http://cybertext.wordpress.com/2010/06/11/word-replace-one-style-with-another/

        now, how to get my images?

        19 Sep 2012
  22. User avatar

    Anonymous

    hi all

    I'm admin and I have all Permissions but I get the following error message when I import Word-Document into Confluence.

    Error Message:   "You don't have permission to edit this page"

    Can anyone please help me?

    Thanks

    Jasi

    24 Oct 2012
  23. User avatar

    Anonymous

    Hello,

    is there any way to import a doc into an existing page ?

    F.e. I have an existing page and the content I'd like to add exists as doc (with screenshots).

    Currently i see no other way as to create a new page..which i then can not merge with the existing page - thus i'd need to cut and paste the bare text, and save and then insert the screenshots. Works, but it ain't pretty (wink)

    Many thanks in advance..

    25 Oct 2012
    1. User avatar

      Ryan Anderson [Atlassian]

      Hello,

      There is no way to perform this operation. You can add a feature request for this functionality here: https://jira.atlassian.com/browse/CONF

      Thanks.

      05 Nov 2012
  24. User avatar

    Anonymous

    Is there a work around /trick to importing Word-files including the screen-shots in the meantime? I've got alot of Wordfiles with alot of screenshots to import. Help would be wonderful

    09 Jul 2013
  25. User avatar

    Anonymous

    Hi, we have problems with embedding documents that contain graphics.

    The graphics all get broken and are shown "in front of" the entire page so that it is even in front of the comment field.

    What do we do wrong? And how can we change the problem? To save the document first as pdf and embed it as a pdf is not what we want because then the graphics are too small and I think there should be another easier way.

    Thanks in advance.

    06 Sep 2013
    1. User avatar

      Anonymous

      Can please someone help us?? (sad)

      18 Sep 2013
  26. User avatar

    Mary Jo Dockman

    We use Conf 5.3.1. When the "Import Word Doc" function is used, the numbering in the imported document does not transfer correctly to the wiki page. Often times, numbers are restarted at 1 where they should be continual numbering, etc.  We want the document to come over exactly as it looks in the Word document with respect to numbering, bullets, tables, etc.

    11 Nov 2013
  27. User avatar

    Jacqueline Cabral

    I am having the same problem as Mary Jo Dockman with numbers restarting at one. Has this issue been resolved?

    15 Jun 2014
  28. User avatar

    Joe Collins

    Is there any way to format a document so that when confluence imports it, the page will be broken into sections?  I use the document import feature to create most of my confluence wiki pages.  This feature has saved me hundreds of hours however, in order for me to be 100% faster I would need two additional features. 

    1. The ability of confluence to interpret where I want sections to start and end within the same page.
    2. The ability to create macro's based on some text/formatting wthin the word document.
      1. For exampe:     ~~Section Start~~  ||Include Page | Page Name || ~~Section End~~  Would create a section within
        the newly created page.  Inside the section would be the Macro 'Include Page' which would be set to include the page content of 'Page Name.'  This would allow me to create fully formatted, customized pages upon import.
      2. OR If confluence would ask (optionally) what template I would like to use to import the document, it would solve this problem as well.
    18 Nov 2014
  29. User avatar

    Edward

    10 May 2015
    1. User avatar

      Giles Brunning [Atlassian Technical Writer]

      Hi Edward,

      Thanks for bringing it to our attention; I've fixed the broken link. (smile)

      11 May 2015
  30. User avatar

    Broadcom Support

    • Import as a new page in the current space - a new page will be created as a child of the current page.

     

    It is actually creating a new page under the "Home" page, not under the "current page". Confirmed with Confluence 5.5.7 & 5.7.4

    11 Jun 2015
    1. User avatar

      Natalie S.

      This is also happening in 5.7.1.

      11 Jun 2015
      1. User avatar

        Giles Brunning [Atlassian Technical Writer]

        Hi Natalie and Broadcom Support,

        You're absolutely right; I've fixed up the doc.

        12 Jun 2015
        1. User avatar

          Broadcom Support

          Thanks Giles, but actually we want it to be created under the current page! 

          12 Jun 2015
          1. User avatar

            Giles Brunning [Atlassian Technical Writer]

            Sorry, I don't have the power to make that happen. Feel free to make a suggestion, though.

            12 Jun 2015
            1. User avatar

              Broadcom Support

              Created  CONF-37885 - Import Word Document to actually create as a child of the current page Open

              12 Jun 2015
Powered by Confluence and Scroll Viewport