description: >- Load data from Notion Database (each row is a separate document with all properties as metadata).

Notion Database

Notion is a collaboration platform that combines note-taking, knowledge management, and project management. This module provides three different loaders to process Notion content: Database, Page, and Folder loaders.

Notion Database Loader

The Database loader extracts content from Notion databases, treating each row as a separate document.

Features

• Load database rows as documents
• Extract properties as metadata
• Support property headers
• Handle concurrent loading
• Process content with text splitters
• Customize metadata extraction

Required Parameters

• Connect Credential: Notion API credentials
• Database Id: The unique identifier of the Notion database

Common Features

All Notion loaders support:

Optional Parameters

• Text Splitter: A text splitter to process the extracted content
• Additional Metadata: JSON object with additional metadata
• Omit Metadata Keys: Comma-separated list of metadata keys to omit

Outputs

• Document: Array of document objects containing metadata and pageContent
• Text: Concatenated string from pageContent of documents

Authentication

API Authentication (Database & Page Loaders)

• Requires Notion Integration Token
• API rate limiting handled automatically
• Support for workspace-level access
• Secure credential management

Local Access (Folder Loader)

• No authentication required
• Direct file system access
• Process offline content
• Handle exported data

Document Structure

Each document contains:

• pageContent: Extracted text content
• metadata:
  • source: Original source (URL or file path)
  • title: Page or database title
  • properties: Notion properties
  • Additional custom metadata

Notes

• API loaders require Notion integration setup
• Folder loader needs exported content
• Rate limiting handled automatically
• Memory-efficient processing
• Error handling for invalid inputs
• Support for large datasets
• Flexible output formats
• Metadata customization

{% hint style="info" %} This section is a work in progress. We appreciate any help you can provide in completing this section. Please check our Contribution Guide to get started. {% endhint %}