Share:
ClickHelp Documentation

Import from Confluence

If you are looking to migrate from Confluence Server or Confluence Cloud, ClickHelp would be a great destination. ClickHelp is a strong alternative to both Confluence Server and Confluence Cloud in terms of functionality and robustness.

To migrate, you will first need to export your existing content from Confluence. The best format would be either zipped HTML or Word (DOCX, DOC, and RTF are all accepted). 

Importing Zipped HTML

Once you have exported your space to HTML, you will have a .zip archive with all of your content at hand.

  1. Head over to your ClickHelp Author Dashboard.
  2. Click Import Document
  3. On the first step of the Import Wizard, among the import formats, select the second option — HTML Zipped.

    Then specify other settings:
    1. Where to import the document to. Most likely, you will want to import it to a new project. Unless you want to merge several Confluence spaces into one project.
    2. Project name — this is what your authors will see in their Dashboard, in the reports, etc. Basically, this is the Confluence space analog.
    3. Project ID — this is a unique project id that is used in its URL.
    4. Project language. Since you can not change a project's language after its creation, it's important to set the correct language during the project's creation.
  4. Click Next.
  5. Drag&drop your archive into the drop zone or click on the zone and browse your way to it. 
  6. While you wait for the archive to finish uploading, you may want to specify the Topic encoding and Split into topics by settings. Usually, there's no need to touch these settings, as ClickHelp can detect the encoding automatically, and Confluence puts each article into a separate HTML file, so the default settings for both settings are optimal.
  7. Click Next and wait for the Wizard to finish importing your project.
  8. On the final screen of the Wizard, you will see the links to your imported project and style files.

You can now click Finish to see your Imported Manual on the Author Dashboard. Click on its name or the Open button to open the Topic Editor screen.

Most likely, your topics were imported without any hierarchy, and all of them were placed on the root level or under a single root folder, even if you had a hierarchy set up in your Confluence space. This is because Confluence places all of the HTML files in a single folder, while ClickHelp looks at the HTML files hierarchy when performing the import. To prepare your archive for ClickHelp to preserve TOC hierarchy, you can read instructions in the following topic: Preparing HTML For Import And TOC Hierarchy.