Documentation for Confluence 5.5.
Documentation for Confluence Cloud and earlier versions of Confluence is available too.

Skip to end of metadata
Go to start of metadata

This page describes how to get text, pages, images and other content into Confluence, by converting the content from another storage format and importing it into the Confluence wiki.

Importing content from other Confluence sites

For content originating from other Confluence sites, you can:

  • Import an entire Confluence site into a new site.
  • Import a space from one Confluence site into another. Page history, attachments, and page content will be preserved and you will be able to do multiple pages at once. The drawbacks are that it may be inconvenient if the Confluence versions differ, and you cannot have a duplicate space key on the destination instance.

On this page:

Related pages:

See Restoring a Site and Restoring a Space for more information.

Importing content from other wikis

Check whether the Universal Wiki Converter can import the content. See Importing Content from Another Wiki

Importing content from a Microsoft Word document

The Office Connector in Confluence allows you to import a Word document into Confluence. The document's content is copied onto one or more Confluence pages. See Importing a Word Document into Confluence.

Importing web content

Here are some options for importing or displaying web content on a Confluence page:

  • Use the Widget Connector Macro to display videos, slide shows, twitter chats, documents and more, sourced from other web sites and displayed on your Confluence page.

Importing other non-wiki content

Importing non-wiki markup into Confluence requires a conversion process:

Note about add-on support

Before installing an add-on (also called a plugin) into your Confluence site, please check the add-on's information page to see whether it is supported by Atlassian, by another vendor, or not at all. See our guidelines on add-on support.

  • No labels


  1. Hi,

    Is there a way to import / retrieve a backed up space? Essentially we have a QA space that we want to move to prod and while there's export functionality we don't see an import button. Thanks!

    1. You re-import through the admin console backup/restore section for both space backups and site backups.

  2. Anonymous


    I was just curious to know if there is a plan to include importing non-wiki content (e.g. .xls, .pdf, .doc) as an out of the box function of enterprise wiki.

    1. Hi there,

      As far as I am concerned, there is an ongoing feature request at CONF-928 to import Word documents into Confluence. There is also a feature request to allow PDF files to be displayed in Confluence.

      Meanwhile, please take a look at how the new features and improvements are being implemented in the future versions of Confluence:


  3. Hi
    I have been looking for a way to import all existing content from a customer - e.g. from databases and shared drives - into Confluence.
    Is there anyway to do that? How?
    Keep up the great work! (smile)
    Thank you!

    1. Hi,

      I am sorry that I am not sure what type of content that you want to import from the database and shared drive. As for my suggestion, try using the Importing Page from disk method, WebDAV plugin or Content converter plugins. Feel free to clarify if I have misinterpreted your question.(smile)


  4. When importing content from other Confluence sites, how are userIDs mapped to existing (or non-existing) IDs in the destination instance?

    We have several Confluence instances, some using External User management (JIRA), others with their own userbase.

    Some folks have IDs in both Confluence instances. We want to move content between instances and preserve the user-to-content associations.

    1. Hi Roy,

      The mapping of the content and user ID (ownership) is solely based on the username, be it from local or external (e.g. LDAP, JIRA). Confluence will not alter the author of the contents during an import; any existing user in the target isntance with the same username will automatically own the imported contents. If there is no existing user, Confluence will keep the author as it is.

      Hope that helps,

  5. Is there a way to update pages in my space at one go, regularly? We have our product documentation in confluence, we want to keep the modified content in confluence, on a regular basis. Our pages are in htm format. Thanks!

    1. Do you mean that you want to have an application or process which update your space regularly? If so, I would suggest you to develop a soap/xmlrpc client to update Confluence regularly. Currently, Confluence does not have such application bundled. The following may be useful for you to shed an idea on how to update Confluence's space:


  6. Anonymous

    Any chance of getting the functionality of the old mydashboard.eng built into the Wiki ??? It was a great way to track tasks and indicate status. 

    1. Hi, there. I am sorry that I could not understand your requirement. Would you mind to clarify?

  7. I created a sandbox for anonymous users on our trial site.  How can I prevent them from importing Word docs, as there's not an option in the permissions for the space.  Thanks.

    1. Hi Gina

      I created a sandbox for anonymous users on our trial site. How can I prevent them from importing Word docs, as there's not an option in the permissions for the space. Thanks.

      As far as I know, the Doc Import option will only display to user if the user has the Create page permission in the space.

      Please let me know if I have misinterpreted your question.

      Best rgds,

      1. Zed,

        Yes, I changed the space permission so that Anonymous Users could not add pages, they can only add comments. 

        Thanks very much.


  8. i have a set of wiki pages (> 100 pages, so manual copy wont work) that i need to move or copy from a confluence 2.10.x wiki site to a confluence 3.0.x site, what are my options?  Note:  i am not moving or copying the whole wiki space, so importing a space wont work.  Thanks!!

    1. As a space import only compatible with backups created within the same major releases, your option is to upgrade the Confluence 2.10.x instance to 3.0.x instance separately. Then, export/import the spaces into the main 3.0.x instance and start moving the pages around. I understand that this process is not trivial, but it seems to be the best option.

      Alternatively, if you are willing to indulge in development work, create a remote client that copies the wiki markup (and attachments) of the pages from 2.10.x into 3.0.x.

      Additionally, if you are on 3.0.x, please be aware of this known issue.

      Hope this helps!

  9. Is there a way (macro) to dynamically import external content residing on another confluence? Many can specify importing content from another space on same confluence, it would be very useful to have a way to collaborate across multiple confluence.

    1. Have you tried the Confluence page gadget? Let us know if it does what you're looking for. (smile)

  10. Anonymous

    Hi there,

    Is there anyway to import all the contents from a WordPress 3.0 blog and Wiki into Confluence?


    1. I wrote a little script in php to import my content from a WordPress 3.3 XML-export into Confluence 4.2. Maybe it helps.

  11. Anonymous

    In 3.2, in the Conf Admin, the statement "Restoring space backups are incremental, meaning that restoring them will not wipe out everything that currently exists." but in the docs for restoring it says "Confluence will only allow you to restore a space if there is not already a space by that name on the site. If you already have a space with the identical name, you will need to delete or rename the existing space before restoring the new one."

    If I have to delete the space, how is that incremental suppose to work?

  12. Anonymous

    How do you copy a single page from one server to another?

    On download site:

    • Export Space (stupidly needs space admin), select the one page, download the XML.

    On upload site:

    • Confluence Admin (stupidly needs confluence admin), select the space, upload the XML? 
      • this feels really heavy weight for a one off page move

     Thanks, M.

  13. Anonymous


    I use Confluence 3.5, and have 5000 pages of FrameMaker documents to export to Confluence. We have nearly finished writing our own conversion system which ultimately converts to WIKI Markup format. I have some questions about Confluence 4:

    1. Is it possible to have the tag guide for the new XML format, like we have for WIKI Markup? I have a load of tables with merged cells, and it might be worth scrapping my WIKI Markup convertor in favour of a straight XHTML conversion. Also it's one level of indirection less! (smile)
    2. How long will WIKI Markup be supported as an "intermediate" import format?

    We've tried the third-party solution (outputting to WIKI Markup) and prefer to write our own.



  14. Here's a contribution I made a while back for converting HTML to Confluence. This will actually take a whole site directory, convert, and upload the content. There's a post in the forums covering H2C here:

    Project page:

    1. Hi Jason, thanks very much for your reply. As far as I can tell from looking at the python, this still converts to WIKI Markup. I was hoping to cut out the intermediate stage and convert directly to the new Confluence 4 format.

      1. What is the existing format of the data you're trying to import? You could just turn the actual markup conversion off. I believe there is an option for that. If your content is in HTML, you probably won't have much problems importing and using as is. There may still be a few tags that confluence doesn't recognize, but I believe most the basic tags are supported in the confluence 4 format. I'm not sure how code savvy you are, but you may also easily an option to convert to Conf4 xml markup.

        1. The data starts life as a proprietary binary format native to FrameMaker. FrameMaker outputs to HMTL. I admit that I haven't tried importing the HTML into Confluence 4 yet - because I don't dare upgrade our 3.5 installation! And as far as I'm aware, there's no "sandbox" version of Confluence 4 yet. I would feel far more comfortable upgrading to 4 if I had a Tag Guide for Confluence 4, just as I had a Tag Guide forConfluence 3 (i.e. Wiki Markup).

  15. Since there is no more the option to email the entire post content, can we do it the opposite way?

    Some blogging platforms allow you to make posts via email.

    I was thinking, if I made the post via email, I could include the group of people I wanted to include, about 37 people, plus the email address for the post via email function. That way everyone would get the content in the email AND the post would be made for documentation purposes.

    Can we post via email to Confluence?

  16. Do you plan to update the Import Pages from Disk feature to handle the storage format? I've got MIF2Go exporting my FrameMaker source to XHTML. It seems ridiculous that I have to import it page by page or write my own tool to import a whole set of pages.

    I've never adopted a tool that was as limited in its import options as Confluence 4.2 currently is. The Word import has serious bugs and apparently Atlassian has no plans to fix them.


  17. Does a method exist to import pages from Mindtouch directly to confluence 4.2.3 ?

    1. Not last time I checked. The Universal Wiki Converter converts MindTouch to Confluence 3.x wiki markup.

  18. Are attachments supposed to come along for the ride in an import from installed version to OnDemand?  The imports of wiki pages are working, but all attachments are missing after the import.  (images, Gliffy's, etc)  Is this the expected result after an import?

    1. Hi Nicole Hushka, attachments should be imported. Please file a support ticket for this.

  19. Anonymous

    Is there a way to merge various Confluence installation into a single Install?  I have a 4.3.X instance as well as a 3.X instance (backed by MySQL).  I would like to merge these 2 into a single install. 

    I am thinking of bringing them both to a common 4.3.X version first.  Then export one space at a time and import into the other. 

    The issue I think I will run into will be the export to XML.  The spaces are fairly large and definitely will not work as XML export.   Is there a way to merge Confluence via MySQL Export/Import ?

  20. Is there any way for a space admin who is not a system admin to import content? The "Import pages from disk" option is only available to system admins.

  21. I can't find much on converting unstructured FrameMaker files to Confluence. We're hoping to move the FM user guide content to wiki for user access. I tried converting FM files to PDF, then convert PDF to Word, but the imported content needs so much reformatting that it's almost futile. Any other ideas or thoughts on how I can achieve our goal?

    1. I got MIF2Go to the point of being able to export XHTML that I could paste into the Confluence editor in source mode page by page:

      The next step would be to find a way to export a set of pages with links:

      Re: Feedback on Confluence Storage Format

      There's some stuff about that on the MIF2Go forum, which seems to have forgotten my login:

      You'd also need to find some way to do a bulk import. Here's my failed attempt:

      I think there are links to another attempt or two in the pages I linked to above.

      It's incredible how hard it is to migrate content into Confluence, isn't it? I wonder if the powers that be at the company understand how much business they're losing by having such limited import capabilities. Or maybe they don't realize the extent to which the switch from wiki markup to XHTML broke the old import options.

  22. Hi,

    Can this work to with Confluence 3.5.3? Or there is a different procedure of importing/exporting Confluence 3.5.3 pages to another (different) Confluence site?

    If so, what are the file formats for these?

    Hope you can help me on this!

    Thanks in advance!

    1. Hi Ryan, you might want to have a look at the documentation for your version of Confluence (3.5) here -  Importing Content Into Confluence.   Note that if you are wanting to export pages from one Confluence instance and import them into another instance, both instances will need to be running the same major version of Confluence. 

  23. Anonymous

    Hi, can you tell me whether there exists a maximum how big pdfs or other documents may be to import them? Yesterday a staff tried to import a pdf with 180 pages and killed the system for a while.

    Would be nice to get a answer so that we know how to handle this problem.

  24. Anonymous

    Hi, Can you tell me whether there exists a way to import pdf files into confluence?

    1. Anonymous

      f.e. via drag&drop (wink)

    2. Hi anonymous,  the answer depends on what you are trying to do.  If you want to display the contents of a PDF in a Confluence page, you can drag it straight onto the page (this attaches the PDF to the page and then use the PDF macro to display it). 

      If you want to populate your page with content from a PDF that is then editable in your Confluence page - that is not possible. You could however experiment with converting your PDF to Word format and then importing that - see more information here Importing a Word Document into Confluence

      Hope this helps.  Rachel

  25. Anonymous

    I am trying to copy and paste a HTML source content from ZenDesk editor to Confluence Wiki Markup, it seems it does not work Do I need to install the UWC to function

    1. Hi there, the UWC is used to convert data exported from a wiki into a format that can be imported into Confluence. It sounds like what you are trying to do is to paste a single piece of HTML content into the Confluence editor?  

      If so, you could use this Rich Text wikifier which supports HTML and Rich Text inputs and turns them into wikiMarkup that can then be inserted into the Confluence editor (Insert > Wikimarkup) (please note this is an external site and not supported by Atlassian).  This might give you what you are looking for. If not, I suggest that you ask your question at Answers

  26. Hi Rachael,

    Thanks for the post. Appreciate ir. I was told by one of the support representatives (Housin Toussi) to follow this:

    Hi - enable HTML macro from: conf admin > manage add-ons - insert HTML macro inside your page - paste the codes there. I do not have admin access, but I tried in the editor -Insert/Edit Macro>External Content>HTML - paste the source content into it. But I only the content with HTML tags appearing. Not the structured tree, I was looking for  - auto-create number lists, etc.

    Hope you can help or provide a solution. I will look into the RTW and see if it works.

    Also do you need admin rights to create your own macros?



    1. Hi Rahul, the HTML macro should also work, but many System Administrators leave this macro disabled for security reasons.  Chances are this is the case on your instance as well.   

      Yes, you need Confluence Administrator permissions to create user macros. 

  27. "Import a space from one Confluence site into another. Page history, attachments, and page content will be preserved and you will be able to do multiple pages at once."

    Is there a best method for importing one space into another on the same instance of confluence? From what I've read it is hit or miss (that sometimes not all pages are brought over in the "Copy Page Tree" method).

    The version of Confluence I'm using is Version 4.2.11.

    1. Hi Nick, I'm not sure what you mean by importing one space into another. If you are trying to move pages from Space A to and existing Space B I would recommend using the Move Pages function - you can move a whole tree at a time.  There is info on how to do this in Confluence 4.2 here - Moving a Page.  If you want to create a copy of Space A, you could use the Copy Space plugin - which supports Confluence 4.2

      Export and Import works between different instances, but it does not provide the facility to change the space key - so often not useful when importing back into the same instance. 

  28. Anonymous

    Can Confluence import content from Author-it?

    1. I don't know about Author-it specifically, but it may be possible, depending on the output formats that Author-it supports. If you can export your content to Word or to HTML it may be possible to import your content into Confluence.  See Importing Pages from Disk and Importing a Word Document into Confluence for more information. 

  29. When I try to enter confluence wiki markup by directly pasting it in (using Ctrl-Shift-D) and paste in the code for a table of a substantial size (generated by an external program), the server sends back a response saying that the conversion is taking too long and then aborts. I know the conversion should take a long time because the table is huge (700 rows). Is there anyway to tell the server to persevere instead of giving up?

    1. I'm afraid I don't know the answer to this one.  Support may be able to help you however. 

  30. I have submitted a bug for this, but would appreciate any feedback or suggestions from others here.

    When importing PDF files, and viewing them in the Confluence pages, I often find that there are display errors with the PDF viewer. Sometimes pages will have missing elements ... sometimes the entire page will render as blank. Other times an entire PDF document imports and displays as nothing but blank pages.

    Is anyone else experiencing this?  Are there any solutions or workarounds?

    1. Hi Eric, by importing PDF files, do you mean displaying a PDF on a page using the PDF macro?  We've made a number of improvements to this macro in Confluence 5.4.4 release (particularly around the blank pages and missing elements).  See  CONF-19819 - Incomplete PDF rendering in viewfile/viewpdf macro Resolved  and  CONF-26081 - Not all PDF content viewable with viewfile macro Resolved  for more info. 

  31. In the importing non-wiki content section, nearly everything excludes Confluence On Demand. Is importing of non-wiki content supported for Confluence On Demand?

    1. Hi Laura, I'm afraid that's correct.  You can create pages from Word documents, and import Confluence spaces, but the tools required to import content from other wikis or files are not available in OnDemand.