Notion Connector
Connect to Notion to index pages, databases, and workspace content.
Overview
The Notion connector allows you to:
- Index pages and databases
- Traverse nested page structures
- Sync database properties
- Support multiple workspaces
Prerequisites
- Notion account
- Workspace access
- OAuth authorization
Authentication
OAuth 2.0
- Click Connect with Notion
- Select workspace
- Choose pages to share
- Authorize access
Page Selection
During OAuth, select which pages ZenSearch can access:
- Select individual pages
- Select entire databases
- Access flows down to child pages
Configuration
| Setting | Description |
|---|---|
| Workspace | Connected workspace |
| Root Pages | Starting pages for sync |
| Include Databases | Sync database entries |
| Traverse Depth | How deep to follow links |
Setup Steps
- Add Connector: Knowledge → Add Data Source → Notion
- Authorize: Connect with Notion OAuth
- Select Pages: Choose root pages/databases
- Configure Depth: Set traversal options
- Test & Create: Verify and save
Content Indexed
| Content | Included |
|---|---|
| Pages | Yes |
| Databases | Yes |
| Database items | Yes |
| Nested pages | Yes |
| Block content | Yes |
| Comments | Optional |
Database Handling
Notion databases are indexed as:
- Database structure (schema)
- Individual entries as documents
- Properties as metadata
Nested Page Traversal
ZenSearch follows page links:
Root Page
├── Child Page 1
│ └── Grandchild Page
├── Child Page 2
└── Linked Database
Best Practices
- Share root workspace pages for broad access
- Use specific pages for focused indexing
- Include databases for structured data
- Set appropriate traversal depth
Troubleshooting
No pages found: Ensure pages were shared during OAuth
Missing content: Check page sharing settings in Notion
Incomplete databases: Verify database was selected during auth