Why Connect Notion?
Knowledge Base
Use your existing Notion docs as AI knowledge without duplication
Auto-Sync
Content changes in Notion are automatically detected and synced
Semantic Search
AI understands context and meaning, not just keywords
Selective Sync
Choose exactly which pages to include
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
Content Syncing
Notion content is synced automatically according to your plan’s crawl frequency:- Free: No automatic syncing
- Starter: Monthly
- Pro: Weekly
- Turbo: Daily
Incremental Crawling
The integration uses incremental crawling to efficiently update only changed content:- Tracks
last_edited_timefrom 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:- Go to Dashboard → Integrations → Notion
- Click Browse Pages to see accessible content
- Toggle pages to include or exclude
- Click Save Selection
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)
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?”
Troubleshooting
No pages available after connecting
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
Sync status shows 'failed'
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
Content not appearing in search results
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
Changes in Notion not appearing
Changes in Notion not appearing
- Wait for next scheduled sync based on your plan
- Verify changes are saved in Notion
Security: Notion connections use OAuth 2.0 for secure, authenticated access. Your credentials are never stored or shared.
