Settings Reference
N2O settings live in two places:
- N2O Settings tab — connection, account, and plugin-level options. Open via Obsidian Settings > N2O.
- Sync Configuration modal — everything about what to sync and how. Open via the “Open” button in the Settings tab, or “Configure Sync” in the Dashboard.
Settings tab
Section titled “Settings tab”Connection
Section titled “Connection”How you connect N2O to your Notion workspace. You can use OAuth (recommended) or a manual integration token.
| Setting | Description |
|---|---|
| Notion Connection (OAuth) | Connected via browser auth. Buttons: Test, Reconnect, Disconnect. |
| Refresh Accessible Pages | Re-scan Notion for pages shared with N2O (OAuth only). |
| Notion API Token (manual) | Your internal integration token from notion.so/my-integrations. Starts with ntn_. |
| Test | Verifies the connection by calling Notion’s /users/me endpoint. |
| Quick Connect | Switch to OAuth — connect via browser without copying a token. |
| Setup Wizard | Guided walkthrough: token or OAuth, scope selection, folder setup, trial activation. |
See Connect to Notion for first-time setup.
Sync Configuration
Section titled “Sync Configuration”A single button — Open — that launches the Sync Configuration modal. All content, folder, behavior, automation, and output settings live there.
Account
Section titled “Account”| Setting | Description |
|---|---|
| License Key | Paste your license key from your purchase email to activate Pro. |
| Activate / Deactivate | Activate or deactivate your license on this device. |
| Start 14-Day Pro Trial | Begin a free trial — enter an email address to activate. Available once per email. |
| Subscribed | Shows your subscribed email (for product updates). |
Tier limits:
| Free | Trial | Pro | |
|---|---|---|---|
| Databases | 2 | Unlimited | Unlimited |
| Pages | 100 | 200 | Unlimited |
| Direction | Pull only | Bidirectional | Bidirectional |
| Auto-Sync | No | Yes | Yes |
| Custom Templates | No | No | Yes |
Enhanced Metadata (Experimental)
Section titled “Enhanced Metadata (Experimental)”Unlocks additional Notion layout metadata that the official API doesn’t expose — embed subtypes, image sizes, column widths, and automatic linked database view resolution. Requires a Notion session token (token_v2).
| Setting | Description |
|---|---|
| Enable Enhanced Metadata | Toggle to activate the unofficial API alongside the official one. |
| Sign in to Notion | Opens Notion in Obsidian’s Web Viewer for one-click token capture. |
| Grab Token | Reads the token_v2 session cookie from the Web Viewer (easiest method). |
| Session Token (manual) | Paste your token_v2 cookie manually. Found in browser DevTools → Application → Cookies → notion.so. |
| Validate | Tests the token against the unofficial API. |
See Enhanced Metadata for what this unlocks and how to set it up.
Advanced
Section titled “Advanced”| Setting | Description | Default |
|---|---|---|
| Debug Mode | Enable verbose logging in the developer console (Ctrl+Shift+I / Cmd+Option+I). | Off |
| Reset N2O | Clear all sync data, caches, and page selections. License and Notion connection are preserved. | — |
Sync Configuration modal
Section titled “Sync Configuration modal”All sync settings in one place. Organized into 7 collapsible sections.
Content & Folders
Section titled “Content & Folders”What to sync and where it goes in your vault.
| Setting | Description | Default |
|---|---|---|
| What to Sync | Entire Workspace or Selected Pages & Databases. | Selected |
| Choose Pages | Opens the tree picker to browse Notion and select databases/pages. | — |
| Auto-sync child pages | Automatically discover and sync sub-pages nested inside selected pages. | On |
| Auto-sync child databases | Automatically discover inline databases inside selected pages. | On |
| Sync Folder | Root folder in your vault for all synced content. | Notion/ |
| Standalone Pages Folder | Put workspace-level pages (not in any database) in a separate subfolder. | On |
| Standalone Folder Name | Subfolder name when the above is on. | _Pages |
Manual page entry (advanced, collapsed by default): Paste Notion page URLs or IDs directly instead of using the tree picker.
Database Configuration
Section titled “Database Configuration”Per-database settings. Appears only when databases are selected in Content & Folders.
For each database in your sync scope:
| Button | What it opens |
|---|---|
| Filters | Filter Builder — add conditions to control which items are fetched (e.g., Status = “In Progress”). |
| Properties | Property Mapper — rename, reorder, or exclude individual properties from frontmatter. |
Database filters apply to pull sync only. Items that don’t match won’t be fetched from Notion.
Sync Behavior
Section titled “Sync Behavior”How data flows and what happens when things conflict.
| Setting | Description | Default |
|---|---|---|
| Sync Direction (Pro) | Bidirectional, Notion → Obsidian only, or Obsidian → Notion only. Free tier is always pull only. | Bidirectional |
| Conflict Strategy | Ask me, Notion wins, Obsidian wins, or Newest edit wins. | Ask me |
| Conflict Notes | Save a .conflict.md file with the discarded version when auto-resolving conflicts. | On |
| Three-Way Merge | Automatically merge non-conflicting edits from both sides before applying the conflict strategy. | On |
| Download Media | Download images, files, and videos into _files/ folders next to your content. | On |
| Generate Cover Thumbnails | Create smaller thumbnail versions of large cover images for faster gallery views in Bases. Only shown when Download Media is on. | On |
| Sync Deleted Items | When a Notion page is deleted, remove the corresponding vault file. | Off |
Output & Templates
Section titled “Output & Templates”What gets generated alongside your Markdown files.
| Setting | Description | Default |
|---|---|---|
| Bases for Databases | Generate .base files for native Obsidian Bases views (table, gallery, board). | On |
| Default View Type | Default view for generated .base files: Table, Cards, or List. Shown when Bases is on. | Table |
| Include Formulas | Convert Notion formulas to Bases formula syntax. | Off |
| Push property renames | When you rename a property in a .base file, push the rename back to the Notion database schema. Experimental. | Off |
| Canvas for Databases | Generate .canvas files showing database items as visual nodes. | Off |
| Custom Templates (Pro) | Auto-format database items with property cards and hashtags. Per-database toggle when enabled. | Off |
Custom templates use files at _templates/n2o/{DatabaseName}.md in your vault when present.
Create New Pages (Pro)
Section titled “Create New Pages (Pro)”Push new Obsidian files to Notion as new pages — not just edits to existing ones.
| Setting | Description | Default |
|---|---|---|
| Enable Create New Pages | When on, new vault files can be pushed to Notion. | On |
| Parent Page | The Notion page where new standalone pages are created. Paste a URL or ID. | — |
| Source Folder | Limit which vault files trigger new-page creation: entire sync folder, or a specific subfolder. | Entire sync folder |
Database items (files in a database’s subfolder) are always placed in their matching Notion database — no parent page needed for those.
Automation (Pro)
Section titled “Automation (Pro)”Automatic sync without manual triggers.
N2O has two independent mechanisms:
- Auto-Sync — runs a full sync on a timer. Discovers new pages, detects deletions, and updates everything.
- Fast Polling — lightweight real-time check (1 API call). Detects edits and fetches only changed pages.
You can use either, both, or neither.
| Setting | Description | Default |
|---|---|---|
| Sync Mode | Manual (sync only when triggered) or Automatic (runs on a timer). | Manual |
| Auto-Sync Interval | Minutes between full syncs (1–60). | 5 min |
| Fast Polling | Auto-pull Notion edits in real-time. | Off |
| Poll Interval | Seconds between fast-poll checks (5–120). Shown when Fast Polling is on. | 30 sec |
| Auto-Push | Automatically push Obsidian edits to Notion after a delay. | Off |
| Auto-Push Delay | Seconds to wait after your last edit before pushing (3–30). Shown when Auto-Push is on. | 5 sec |
A common combination: Auto-Sync every 15–30 minutes for structural changes + Fast Polling every 30 seconds for instant edits.
Performance
Section titled “Performance”Fine-tune how aggressively N2O syncs.
| Setting | Description | Default |
|---|---|---|
| Sync Concurrency | Pages to sync in parallel (1–10). Higher = faster, but more API pressure. | 5 |
| Full Discovery Interval | Hours between full workspace discovery scans (1–168). Discovery finds new pages/databases added since last sync. | 24 hr |