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

# Notion

> Sync Notion pages and databases to your Duckie knowledge base

Connect Notion to sync your documentation, wikis, and databases as knowledge for your agents.

## Capabilities

| Capability             | Supported                  |
| ---------------------- | -------------------------- |
| **Knowledge Source**   | ✓ Sync pages and databases |
| **Deployment Trigger** | ✗                          |
| **Tool Actions**       | ✗                          |

## Setup

### Connect via OAuth

1. Go to **Settings → Connections** in Duckie
2. Find **Notion** and click **Connect**
3. You'll be redirected to Notion
4. Select which pages/databases to share with Duckie
5. Click **Allow Access**
6. You'll be redirected back to Duckie

<Info>
  You control exactly which pages Duckie can access. Only shared pages will be synced.
</Info>

## Selecting Content to Sync

When connecting, Notion asks you to select pages:

### Option 1: Select Specific Pages

Choose individual pages or databases to share. This is the most secure approach.

### Option 2: Select Parent Pages

Share a parent page to include all its children. Useful for entire documentation sections.

### Option 3: Use Templates

If you have a documentation workspace, share the top-level template pages.

## Syncing to Knowledge Base

After connecting:

1. Go to **Train → Knowledge**
2. Click **Add Source**
3. Select **Notion**
4. Choose from your shared pages
5. Click **Start Sync**

### What Gets Synced

* Page content (text, headings, lists)
* Database entries (as individual items)
* Nested pages (if parent is shared)
* Images (referenced, not embedded)

### What Doesn't Sync

* Comments
* Page history/versions
* Permissions (all synced content is available to agents)

## Keeping Content Updated

Duckie automatically re-syncs Notion content:

* **Incremental sync**: Changes detected and updated
* **Sync frequency**: Every few hours by default
* **Manual sync**: Click "Sync Now" to force update

## Best Practices

### Organize for AI Readability

Structure your Notion pages for clear understanding:

* Use descriptive headings
* Keep pages focused on single topics
* Link related pages together

### Use Databases for Structured Info

Databases work great for:

* FAQs (question + answer properties)
* Product catalogs
* Process documentation

### Create a "Duckie Knowledge" Section

Consider creating a dedicated section in Notion:

* Curated content specifically for support
* Easy to maintain and update
* Clear separation from internal docs

## Example Structures

### Support Documentation

```
📚 Support Docs (share this)
  ├── Getting Started
  │   ├── Quick Start Guide
  │   └── Installation
  ├── Features
  │   ├── Feature A
  │   └── Feature B
  └── Troubleshooting
      ├── Common Issues
      └── Error Messages
```

### FAQ Database

Create a database with:

* **Question** (Title)
* **Answer** (Text)
* **Category** (Select)
* **Last Updated** (Date)

## Troubleshooting

### "Page not syncing"

* Verify the page is shared with Duckie in Notion
* Check that it's selected in Knowledge sources
* Try removing and re-adding the source

### "Content out of date"

* Click **Sync Now** to force a refresh
* Check the last sync time in source details

### "Missing nested pages"

* Ensure the parent page is shared
* Nested pages inherit sharing from parents