Skip to main content

Import content from legacy systems

IMPORTANT!  Please contact our MindTouch Support team to advise on importing content from your legacy systems!

MindTouch customers often have existing knowledge in the form of user manuals, legacy knowledge bases, and help content that is perfectly suited to seed and grow your MindTouch site. 

Importing your legacy content into MindTouch will:

  • Instantly index all content for search
  • Make your knowledge accessible through multiple channels (KaaS)
  • Centralize your knowledge
  • Provide knowledge analysis and feedback
  • Provide support agents access to content 

All content import engagements require completion of an import analysis prior to quoting.  Imports are executed by MindTouch support agents utilizing standardized import processes and applications.  

Content import process

At MindTouch we have a long history of importing and converting content, and we have come to understand that it is a very sensitive operation. Inconsistencies that may be perceived as minor could be compounded across potentially hundreds of thousands of articles. As such, we have developed a process that is focused on aligning expectations and mitigating risk. 

Our three-step process provides a detailed analysis and understanding of exactly what will be executed during the import. It provides a common agreement between both parties as to what can and cannot be accomplished. 

How do I get started?

Your MindTouch account manager can help you get your content import started. Simply contact your account manager and be prepared to provide the following materials/information:

  1. A sample (3% or more) of your knowledge in HTML or .CHM format.
  2. The total count of all your HTML files.
  3. The source application that was used to generate your HTML content.

Supported import formats





Madcap Flare
Adobe Framemaker
Adobe RoboHelp
Legacy CMS
Static HTML

Madcap Flare
Adobe Framemaker
Adobe RoboHelp


HTML files require minimum cleanup and can be imported rapidly.  Does not support expand/collapse.

.CHM files require minimum cleanup and can be imported rapidly.  Does not support expand/collapse.

Supported attachment formats

MindTouch provides both content and attachments to facilitate the help experience. The following file formats cannot be converted or imported into MindTouch and have to be attached to an existing article:  

  • Adobe PDF
  • Microsoft Excel
  • Microsoft PowerPoint
  • Microsoft Visio

Import expectations

  • Images used on pages are attached to each page they are used on. This may cause the same image to be imported multiple times. 
  • Documents referenced by pages are attached to each page that they are referenced on. This may cause the same document to be imported multiple times.
  • Pages that are included two or more times in the hierarchy are imported as transclusions of the original page instead of copies.

Import limitations

  • Pages that are not listed in the .CHM table of contents but that exist in the .CHM manifest will be imported as top-level pages so that links are not broken.  
  • .CHM glossary is not supported.
  • .CHM previous/next navigation is not supported.
  • .CHM pages contain both chrome and content, making it difficult to separate presentation information from actual content, causing both to be imported and requiring a manual cleanup afterward.

  • Was this article helpful?