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

# Notion

> Connect your Notion workspace and sync pages into your chatbot's knowledge base.

Sync content from Notion pages and databases directly into your chatbot. Changes are automatically re-synced on a schedule.

## Prerequisites

* A Notion account with an **internal integration** set up
* The integration must have access to the pages you want to sync

## Connecting Notion

<Info>
  Notion is connected **per-user**, not per-chatbot. Connect once on the Integrations page, then use it across all your chatbots.
</Info>

<Steps>
  <Step title="Go to Integrations page">
    Navigate to **Integrations** in the sidebar.
  </Step>

  <Step title="Click Add on Notion">
    The Notion connection dialog opens.
  </Step>

  <Step title="Create a Notion integration">
    If you haven't already:

    1. Go to [notion.so/my-integrations](https://www.notion.so/my-integrations)
    2. Click **New integration**
    3. Name it (e.g. "FIFE.BOT")
    4. Copy the **Internal Integration Token**
  </Step>

  <Step title="Paste the token">
    Enter the integration token in the FIFE.BOT dialog and click **Connect**.
  </Step>

  <Step title="Share pages with the integration">
    In Notion, open any page you want to sync, click **Share**, and add your integration. Only shared pages will be visible to FIFE.BOT.
  </Step>
</Steps>

## Adding Notion as a Knowledge Source

<Steps>
  <Step title="Open Knowledge Base tab">
    Go to your chatbot → **Knowledge Base** tab.
  </Step>

  <Step title="Click Add Source → Notion">
    If you have one Notion connection, it's selected automatically. If multiple, pick one.
  </Step>

  <Step title="Browse and select pages">
    A page browser shows all pages shared with the integration. Select the ones to sync.
  </Step>

  <Step title="Save">
    Selected pages are fetched, chunked, and embedded.
  </Step>
</Steps>

## Auto-Sync

Notion sources are automatically re-synced on a schedule. The scrape worker checks for changes and re-indexes updated pages.

You can also manually resync individual pages by clicking the **Resync** button next to any Notion source.

## Managing Connections

On the **Integrations** page you can:

* **Rename** a Notion connection (edit the display name)
* **Disconnect** — removes the connection and stops all syncs (knowledge already indexed remains until you delete the source)

## Routing Instructions

Add source-specific routing instructions to your Notion source to tell the AI how to handle content from that workspace.

**Example:**

> "This Notion workspace contains internal process documentation. When citing this source, clarify that these are internal procedures."

## Troubleshooting

| Issue                  | Solution                                                              |
| ---------------------- | --------------------------------------------------------------------- |
| No pages visible       | Make sure you've shared the Notion pages with your integration        |
| Sync failed            | Check that the integration token hasn't been revoked                  |
| Content seems outdated | Trigger a manual resync or check the reindex schedule                 |
| Missing content        | Notion databases show as tables — complex layouts may lose formatting |