Confluence Bulk Import HTML

Has anyone had any luck with this recently?

We're trying to migrate from one Knowledge base to another. I'm able to pull out the content as a CHM, then convert it to HTML and attachments using a converter. But, I'm having trouble getting the HTML imported into Confluence.

Here are the solutions we're currently trying:

  • Built-in Confluence file importer (didn't work - is getting hung up on the fact that the pages are formatted as tables)
  • Confluence's REST API calls to create a page and add an attachment (currently working on this)
  • Universal Wiki Converter (looks like it's no longer supported, as of a long time ago)
  • Bob Swift's Command Line Interface/CLI (loadfiles worked great, but brings it in as HTML code which our users won't be able to support)
  • Bulk convert the HTML to PDF files, then use the REST API to create pages and attach the PDF files (currently working on this, at least it keeps the original formatting of the pages)

Thanks for your help!

1 answer

0 votes


What's the software that you're trying to import from?

Ideally you would be importing XML files but if you let us know the exact software you're coming from we might have some other suggestions.



Hi Shannon,

The software is Moxie. The business member who owns the application is trying to get in contact with the vendor to find out what other export formats they can create for us aside from CHM, so there's a chance that XML may be an option.

And I should clarify in case they see this question that we're doing a proof of concept for the conversion. 

Thanks for asking!


Hi Sarah,

Thank you for confirming that.

So for external sites, here's what we recommend (see Import Content into Confluence)


Import web content

To embed web content on a 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.

  • Embed an external web page into Confluence with the HTML Include macro

  • Use HTML code in a page with the HTML macro

Note: The HTML macro is not enabled in all sites. Talk to your Confluence Admin about whether you can use this macro. 

Importing content from another wiki

Confluence does not provide a method for importing content from another wiki. You may be able to build your own import solution using our REST APIs, as mentioned below, or work with an Atlassian Solution Partner to develop a custom solution. 

Import other content

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

You could work with Moxie as you have been, and let them know your options through Confluence, and hopefully they can work with something for you. The XML to import into Confluence must be Confluence generated, so with Moxie, you'll need to go the HTML or basic text route. Another option is if you have a copy of any of your pages as a Word Document, you could import these.It's still worth trying the unsupported options, as it could work depending on your content.



Thank you very much, Shannon. I appreciate the help!

We'll keep working with Moxie, and trying out the different unsupported options. I'll make a note to come back here once we've found a solution.

For the Word Document option you mentioned, there's not a built-in way to do this in bulk that you know of, is there?

Hi Sarah,

There's not, unfortunately.

I made a feature request for it a few years ago but it didn't gather much interest and was closed:

Thank you in advance for updating us when you find a solution!



Darn, thank you for taking that step! I'll keep that in mind as well. Thanks!

No worries, Sarah! Keep us updated. :) 

Suggest an answer

Log in or Sign up to answer
Community showcase
Posted Feb 06, 2019 in Confluence

Try out the new editing experience

Hi team, I’m Avinoam, a product manager on Confluence Cloud, and today I’m really excited to let the Community know that all customers can now try out the new editing experience and see some of the ...

1,021 views 51 8
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you