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

# Notion

> Use your Notion workspace as a knowledge source for your AI chatbot

Transform your Notion workspace into an intelligent knowledge base for your AI chatbot. Connect pages, docs, and wikis to provide instant answers from content you already maintain.

## Why Connect Notion?

<CardGroup cols={2}>
  <Card title="Knowledge Base" icon="book">
    Use your existing Notion docs as AI knowledge without duplication
  </Card>

  <Card title="Auto-Sync" icon="refresh">
    Content changes in Notion are automatically detected and synced
  </Card>

  <Card title="Semantic Search" icon="magnifying-glass">
    AI understands context and meaning, not just keywords
  </Card>

  <Card title="Selective Sync" icon="database">
    Choose exactly which pages to include
  </Card>
</CardGroup>

## Prerequisites

* Active Notion workspace with pages you want to use as knowledge
* A BubblaV website with an active subscription
* Notion OAuth credentials configured in your environment

## Setup Steps

<Steps>
  <Step title="Navigate to Integrations">
    Go to **Dashboard** → **Integrations** → **Notion**
  </Step>

  <Step title="Connect Workspace">
    Click **Connect Notion** and authorize via OAuth
  </Step>

  <Step title="Select Pages">
    Browse your workspace and select pages to sync
  </Step>

  <Step title="Wait for Sync">
    Content will sync automatically based on your plan's frequency
  </Step>
</Steps>

***

## Content Syncing

Notion content is synced automatically according to your plan's crawl frequency:

* **Free**: No automatic syncing
* **Pro**: Weekly
* **Turbo**: Daily

### Incremental Crawling

The integration uses incremental crawling to efficiently update only changed content:

* Tracks `last_edited_time` from Notion API
* Only fetches and re-processes modified pages
* Saves resources and speeds up sync cycles

### Supported Content Types

| Block Type       | Output                       |
| ---------------- | ---------------------------- |
| Headings (H1-H3) | Plain text with markers      |
| Paragraphs       | Plain text                   |
| Bullet lists     | `- item` format              |
| Numbered lists   | `1. item` format             |
| To-do items      | `[x]` or `[ ]` format        |
| Code blocks      | Formatted code with language |
| Quotes           | `> text` format              |
| Callouts         | `> text` format              |
| Dividers         | `---` separator              |
| Images/Files     | `[type]` placeholder         |

***

## Selecting Sources

After connecting, you can browse and select specific sources:

1. Go to **Dashboard** → **Integrations** → **Notion**
2. Click **Browse Pages** to see accessible content
3. Toggle pages to include or exclude
4. Click **Save Selection**

<Tip>
  Start with your most important documentation pages and expand from there. Selective syncing keeps your knowledge focused and relevant.
</Tip>

***

## Sync Status

Each selected page has a sync status:

* **pending**: Waiting to be synced
* **syncing**: Currently being processed
* **synced**: Successfully synced and up-to-date
* **failed**: Error during sync (check error message)

View status and last sync time for each source in the integration settings.

***

## Test Your Integration

Try these queries on your website:

* "What's your return policy?" (if in your docs)
* "How do I reset my password?"
* "What are your pricing plans?"

The AI will search your Notion content and provide accurate answers.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="No pages available after connecting">
    * Verify you granted access to your workspace during OAuth
    * Check that you're selecting from the correct workspace
    * Ensure pages are shared with the integration
  </Accordion>

  <Accordion title="Sync status shows 'failed'">
    * Page may have been deleted or moved
    * You may have lost access to the page
    * Check error\_message in the integration settings
    * Try re-syncing the page
  </Accordion>

  <Accordion title="Content not appearing in search results">
    * Wait for sync to complete (check status)
    * Verify the page is selected as a source
    * Check that content has actual text content
  </Accordion>

  <Accordion title="Changes in Notion not appearing">
    * Wait for next scheduled sync based on your plan
    * Verify changes are saved in Notion
  </Accordion>
</AccordionGroup>

<Info>
  **Security**: Notion connections use OAuth 2.0 for secure, authenticated access. Your credentials are never stored or shared.
</Info>