Import from Confluence

If you or one of your teams has already been using Confluence as a knowledge base solution, you may have a lot of content there you'd like to move over to KnowledgeOwl. You can import that content from a Confluence space directly into your KnowledgeOwl knowledge base with a few clicks.

Before you begin

Before you can import content into KnowledgeOwl, generate an HTML export of your Confluence space.

Refer to Confluence's instructions for your setup:

• Confluence Cloud: Follow the instructions to Export a space. Be sure you export as HTML.
• Confluence Server: Follow the instructions to Export multiple pages to HTML or PDF section. Be sure you export as HTML.

Download the zipped archive file and have it ready.

Import your content from Confluence

Follow these steps to import from Confluence:

1. In KnowledgeOwl, go to Tools > Imports. The Import content page opens.
   
2. Under Third-party imports, select Confluence. The Import Confluence content page opens:
   The Import Confluence content page
3. To Upload your Confluence HTML export zip file, drag the file into the box or select the box, browse to the file, and select it to upload.
4. Once KnowledgeOwl recognizes the file, the Upload file button activates. Select it to upload the file.
5. A progress bar displays while the file uploads. Once the Zip file uploaded successfully message displays, select Start import in that confirmation message:
   Select Start import once you see the Zip file uploaded successfully message.

The page refreshes to display a progress bar. Once the import completes, a confirmation message displays.

If you're testing the import in a new knowledge base and want to make changes and try to re-import, delete this knowledge base and create a new knowledge base to re-test the import. Refer to Testing imports for more details.

How the Confluence import works

Confluence and KnowledgeOwl are formatted and architected differently, so the importer does some converting as it goes.

Architecturally, Confluence doesn't have the concept of categories versus articles, it just uses pages, which can be parent or child pages. When we import them, we convert parent pages to custom content categories. Child pages without any children are converted to articles.

We also perform these style/formatting cleaning steps, designed to get your content behaving like native KnowledgeOwl content as quickly as possible:

• Remove all element class names.
• Remove all inline styles (setting fonts, font sizes, colors, etc.).
• Remove <style> blocks from within articles to ensure articles get your knowledge base's default styles.
• Other than the article title, we migrate all h1s to h2s, h2s to h3s, and h3s to h4s, since we display the article title as the lone h1 on the page.
• For all image elements, we add our img-responsive class, which helps guarantee the image will resize based on different screen sizes.
• For all tables:
  • Add our "table-bordered" class, which we add to new tables by default.
  • Add style="width: 100%;" to the table to match our default.
  • Move <tbody><tr><th> rows into <tbody><thead> rows, so they get our table header styles.

Import failures

If your file fails to import, we'll warn you that there was an issue:

Sample import failed message

Please contact us and share the HTML zip file that caused the failure so we can troubleshoot what went wrong.