MadCap Flare Integration

Import technical documentation from MadCap Flare projects

Import technical documentation from MadCap Flare projects. AGO parses Flare output files and imports your structured content with its table of contents and hierarchy preserved.

Overview

The MadCap connector:

• Imports MadCap Flare HTML output
• Preserves table of contents structure
• Maintains topic hierarchy
• Supports multiple build targets

Prerequisites

• MadCap Flare project with HTML output
• Exported/published Flare content

Setup

1. Export from Flare

   1. Open your MadCap Flare project
   2. Build your target (HTML5 or similar)
   3. Locate the output folder with generated HTML files
2. Create Knowledge Source

   1. Navigate to Knowledge → Sources
   2. Click Create Source
   3. Select MadCap as the source type
   4. Configure the required settings:
      • Directory path: The folder containing the exported HTML files
      • TOC file path: The relative path to the .fltoc table of contents file
      • Profile: The MadCap build target profile to use
   5. Save the source
3. Sync Content

   1. Click Sync to import the documentation
   2. Review imported topics in the source tree

Content Structure

The connector imports:

Content Type	Description
Topics	Individual Flare topics as documents
TOC	Table of contents as document hierarchy
Cross-refs	Internal links between topics

Best Practices

• Use a dedicated Flare target for AGO import
• Keep TOC structure consistent
• Re-sync after publishing updates
• Review imported content for formatting issues

Troubleshooting

Missing Topics

Symptom: Some topics not imported.

Solution: Verify topics are included in the TOC and published in the build target.

Broken Hierarchy

Symptom: Documents appear flat instead of hierarchical.

Solution: Check that TOC structure is properly defined in Flare project.

---

Related Documentation

• Knowledge Connectors - All available connectors
• Knowledge Source Management - Managing sources