> ## Documentation Index
> Fetch the complete documentation index at: https://ago.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<Steps>
  <Step title="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
  </Step>

  <Step title="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
  </Step>

  <Step title="Sync Content">
    1. Click **Sync** to import the documentation
    2. Review imported topics in the source tree
  </Step>
</Steps>

## 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

<AccordionGroup>
  <Accordion title="Missing Topics">
    **Symptom:** Some topics not imported.

    **Solution:** Verify topics are included in the TOC and published in the build target.
  </Accordion>

  <Accordion title="Broken Hierarchy">
    **Symptom:** Documents appear flat instead of hierarchical.

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

    ***
  </Accordion>
</AccordionGroup>

## Related Documentation

* [Knowledge Connectors](./knowledge-connectors) - All available connectors
* [Knowledge Source Management](../features/knowledge-source-management) - Managing sources