Skip to main content
The Notion connector enables Omni to index and search content from your Notion workspace, including data sources, pages, database entries, properties, and nested content blocks.

​
Overview

​
What Gets Indexed

SourceContent
Data sourcesData source title, description, and property schema definitions
Data source entriesPage content, properties (title, select, date, people, relation, rollup, etc.), and nested blocks
Standalone PagesFull page content including all nested blocks
Block TypesParagraphs, headings, lists, code blocks, tables, toggles, bookmarks, equations, callouts, and more

​
How It Works

  1. You create a Notion internal integration and share content with it
  2. The connector syncs all shared data sources and pages via the Notion API
  3. Page content is rendered from blocks — nested children are fully traversed and included
  4. Data source entries include rendered property values in the indexed content
  5. Incremental sync fetches pages and data sources modified since the last sync
The connector uses read-only access. Omni cannot modify any content in your Notion workspace.

​
Prerequisites

Before setting up the Notion connector, ensure you have:
  • Notion account with permission to create integrations
  • Omni deployment with the Notion connector service running

​
Setup

​
Step 1: Create a Notion Internal Integration

  1. Go to My Integrations
  2. Click New integration
  3. Select the workspace you want to connect
  4. Give the integration a name (e.g., “Omni Search”)
  5. Under Capabilities, ensure these are selected:
    • Read content
    • Read user information with email addresses
  6. Click Save
  7. Copy the Internal Integration Secret (starts with ntn_)
Keep your integration secret secure. Anyone with access to this token can read content shared with the integration.

​
Step 2: Share Content with the Integration

Notion integrations can only access pages, databases, and data sources that have been explicitly shared with them. This is a critical step. To share a page, database, or data source:
  1. Open the page or database in Notion
  2. Click the … menu in the top-right corner
  3. Scroll to Connections and click Connect to
  4. Find and select your integration (e.g., “Omni Search”)
Share top-level pages to grant access to all their child pages automatically. For example, sharing a team wiki’s root page will make all nested pages accessible to the connector. Share databases/data sources directly when you want entries and property schema to be indexed.

​
Step 3: Connect in Omni

  1. Navigate to Settings → Integrations in Omni
  2. Find Notion and click Connect
  3. Enter your Internal Integration Secret
  4. Click Connect
  5. Click Sync to start the initial sync
Your Notion connector is now configured. Initial indexing may take a while depending on the amount of content in your workspace.

​
Managing the Integration

​
Viewing Sync Status

Navigate to Settings → Integrations to view the sync status for each source directly on the list, including last sync time, number of indexed items, and any errors. Click Settings on a source for more details and sync history.

​
Sync Modes

The Notion connector supports two sync modes:
ModeDescription
FullSyncs all shared data sources, data source entries, and standalone pages (used for initial sync)
IncrementalSyncs pages and data sources modified since the last sync (used for updates)
After the initial full sync, the connector automatically performs incremental syncs to capture new and updated content.

​
Adding More Content

To index additional pages or databases:
  1. Share the new content with your integration in Notion (see Step 2)
  2. The next sync will automatically include the newly shared content

​
Removing the Integration

  1. Navigate to Settings → Integrations
  2. Click Settings against the Notion source
  3. Click Delete Permanently

​
Troubleshooting

The integration secret may be expired or revoked.Solution:
  1. Go to My Integrations
  2. Select your integration and regenerate the secret
  3. Delete the existing Notion source in Omni and reconnect it with the new secret
Notion has API rate limits. The connector handles these automatically with exponential backoff.Solution: Wait for the connector to retry. For large workspaces, initial sync may take longer due to rate limits.
Data source entries are only indexed if the parent database/data source is shared with the integration.Solution: Ensure the database or data source itself (not just individual entries) is shared with the integration via Connections.

​
Security Considerations

  • Read-only access: The connector only reads page and database content
  • Token security: Integration secrets should be treated like passwords
  • Encrypted storage: Credentials are encrypted at rest in Omni
  • Explicit sharing: Only content explicitly shared with the integration is accessible — the connector cannot access your entire workspace by default

​
Permissions

The Notion connector uses workspace-level permissions. All members of the Notion workspace can access synced content in Omni. Content visibility in Omni is determined by what has been shared with the integration — only pages, databases, and data sources explicitly shared with your Notion integration (see Step 2) are indexed and searchable.

​
What’s Next

Search Your Data

Learn how to search across Notion pages

AI Assistant

Ask questions about your Notion content

Add More Connectors

Connect additional data sources