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

# Connect Notion as a Knowledge Source

> Step-by-step guide to sync your Notion workspace with AGO

Connect a Notion workspace to AGO so your agents can answer questions from your Notion content.

## Prerequisites

* Admin access to your Notion workspace
* Admin or staff access to AGO

***

<Steps>
  <Step title="Add a Notion Source">
    1. Navigate to **Knowledge** > **Sources**
    2. Click **Add Source**
    3. Select **Notion**
  </Step>

  <Step title="Authorize the Integration">
    1. Click **Connect to Notion**
    2. You will be redirected to Notion's authorization page
    3. Select the pages and databases you want to share with AGO
    4. Click **Allow Access**

    <Note>
      You can always change which pages are shared later from Notion's integration settings.
    </Note>
  </Step>

  <Step title="Select Content to Sync">
    After authorization, AGO displays the pages and databases available for sync.

    1. Browse the page tree and select the content you want to import
    2. You can select entire sections or individual pages
    3. Click **Save**

    <Tip>
      Start with a focused subset of content. Syncing too much irrelevant content can dilute your agent's answers.
    </Tip>
  </Step>

  <Step title="Wait for the Initial Sync">
    The first sync may take a few minutes depending on the volume of content.

    * Track progress on the **Sources** page — the status indicator shows sync state
    * Once complete, check the document count to verify the right content was imported
  </Step>

  <Step title="Verify Content Quality">
    1. Navigate to **Knowledge** > **Quality**
    2. Filter by your Notion source
    3. Review quality scores for imported documents
    4. Fix any flagged issues at the source in Notion, then re-sync

    Common Notion-specific issues:

    * **Nested toggles** — deeply nested content may not import with full structure
    * **Database views** — only the default view is imported
    * **Embedded content** — external embeds (videos, iframes) are not imported
  </Step>

  <Step title="Assign to an Agent">
    1. Navigate to **AI Studio** > **Agents**
    2. Edit your agent
    3. Under **Knowledge Sources**, select the Notion source
    4. Click **Save**

    Your agent can now answer questions from your Notion content.
  </Step>
</Steps>

## Ongoing Sync

AGO automatically syncs Notion content based on your configured schedule. When you update a page in Notion, the changes will appear in AGO after the next sync.

To trigger a manual sync:

1. Go to **Knowledge** > **Sources**
2. Click on your Notion source
3. Click **Sync Now**

***

## Troubleshooting

| Issue                    | Cause                                        | Fix                                                                |
| ------------------------ | -------------------------------------------- | ------------------------------------------------------------------ |
| Pages missing after sync | Pages not shared with the integration        | Go to Notion > Settings > Integrations and share the missing pages |
| Content outdated         | Sync has not run since the change            | Trigger a manual sync                                              |
| Empty documents          | Page contains only unsupported content types | Add text content to the page                                       |
| Authorization fails      | Notion admin restrictions                    | Ask your Notion workspace admin to approve the integration         |

***

## Related

* [Notion Integration](../data-connector/notion-integration) — full configuration reference
* [Knowledge Source Management](../features/knowledge-source-management) — managing all sources
* [Knowledge Quality](../features/knowledge-quality) — quality analysis details
* [Set Up Your Knowledge Base](./knowledge-setup-tutorial) — complete knowledge setup tutorial