Skip to content

Settings Reference

All N2O settings live in one place: Obsidian Settings > N2O Sync, a tabbed panel with six tabs - Connection, Sync, Notionify, Account, Activity, and Advanced.


Connect N2O to your Notion workspace.

SettingDescription
Connect via OAuthAuthorize N2O in your browser (recommended). Shows Disconnect once connected.
Notion API TokenManual alternative - paste an internal integration token from notion.so/my-integrations (starts with ntn_).
SetupOpens the dashboard walkthrough: connect, choose what to sync, run first sync.

See Connect to Notion for setup.


The Sync settings tab with collapsible sections

The Sync tab is a set of collapsible sections. Open the one you need.

What gets synced from Notion.

SettingDescription
What to syncEverything, or selected items (the pages and databases you choose).
Choose itemsOpens the picker to choose specific databases and pages.
Include sub-pagesAlso sync sub-pages nested inside the pages you picked.
Include inline databasesAlso sync databases that live inside the pages you picked.
Include all items from linked viewsSync the whole source database behind a linked view. Off syncs only the items the view’s filter shows.
Manual page entryPaste Notion page URLs or IDs directly (advanced).
Filters (per database)Sync only rows matching conditions (Status = “Done”, etc.).
Properties (per database)Rename, exclude, or reformat properties in frontmatter.
SettingDescription
Sync FolderRoot folder in your vault for synced content.
Standalone Pages FolderPut workspace-level pages in their own subfolder.
Standalone Folder NameThe subfolder name (shown when the toggle is on).
SettingDescription
Sync directionBoth ways, Notion to Obsidian only, or Obsidian to Notion only. (All directions work during the trial and on paid plans.)
When both sides change the same noteAsk me, Always keep Notion’s version, Always keep Obsidian’s version, or Always keep the newest edit.
Keep a backup of the discarded versionSave a .conflict.md note with the version that wasn’t kept, so nothing is lost.
Smart mergeAutomatically combine changes that don’t overlap, so edits on both sides are kept.
Delete local notes removed from NotionDelete the matching vault note when its Notion page is deleted.
SettingDescription
Download MediaDownload images, files, and videos into _files/ folders.
Generate Cover ThumbnailsSmaller cover versions for faster card views.
Auto-organize mediaMove dropped media into the page’s _files/ folder after sync.
File Property ImagesHow file-property images appear: frontmatter only, inline, or hidden.
SettingDescription
Bases for DatabasesGenerate native .base views (needs Obsidian Bases, a core plugin, 1.9+).
Default View TypeTable, cards, or list - used when the Notion default can’t be detected.
Include FormulasConvert Notion formulas to Bases formula syntax.
Push property renames to NotionExperimental - sync property renames back to Notion.
Canvas for DatabasesGenerate a .canvas graph of database items (off by default).

See Databases for how this maps to your vault.

SettingDescription
Custom Templates (Pro)Auto-format database items; one template per database under _templates/n2o/.
SettingDescription
Enable Create New PagesPush brand-new Obsidian files to Notion as pages.
Parent PageThe Notion page where new standalone pages are created.
Source FolderPush new files from the whole sync folder or a chosen subfolder.
SettingDescription
Pages synced at oncePages synced in parallel (1-10). Higher is faster but closer to Notion’s rate limit.
Full re-scan intervalHours between full workspace scans for new and deleted pages (1-168).
SettingDescription
Known Notion pagesRefresh the list of accessible Notion pages, or clear the local cache.
SettingDescription
Get changes from NotionBring Notion changes into your vault automatically. Checks about once a minute while you’re active and backs off when idle. Includes a periodic full re-sync (5-60 min) that also finds new pages and deletions.
Send my edits to NotionSend your edits back to Notion a few seconds after you stop typing (delay 3-30s).

See Sync modes for how these combine.


The Notionify settings tab

Display and fidelity enhancements that make synced content look more like Notion.

SettingDescription
Enable NotionifyNotion-style cell formatting in Bases tables (dates, pills, row icons). Display-only, non-destructive.
Multi-column layoutRender Notion column layouts as side-by-side columns. Takes effect on the next sync.
Enable enhanced metadataUse Notion’s unofficial API for layout metadata and linked-view auto-resolution.
Session Token (token_v2)The cookie that powers enhanced metadata.

The Account settings tab

SettingDescription
License KeyActivate, validate, or deactivate your Pro/Lifetime license on this device.
Start 14-Day Pro TrialBegin a free trial (enter an email; once per email).
Product UpdatesSubscribe or unsubscribe from product update emails.
Share sync diagnosticsSend sanitized, classified sync errors to help fix bugs (on by default; one-click off).
Copy diagnostics for supportCopy a sanitized diagnostics report to your clipboard.

Read-only. Recent Activity lists items changed in the last sync; Sync History shows past sync runs with expandable per-item details.


The Advanced settings tab with System Health, Debug, and Danger Zone

SettingDescription
System HealthStatus of connection, database, cache, metadata, license, last sync, and the file watcher.
Debug ModeVerbose logging in the developer console.
Reset N2OClear sync state, caches, and selections. Keeps your license and connection.
Factory ResetWipe everything, including the license. Back to first-install state.

Free 14-day trialProLifetime
Pages300UnlimitedUnlimited
DatabasesUnlimitedUnlimitedUnlimited
DirectionTwo-wayTwo-wayTwo-way
Automatic sync (both directions)YesYesYes
Custom templatesYesYesYes
PriceFree for 14 days$8/mo$249 once

There is no permanent free tier. After the trial, syncing is locked until you start Pro or Lifetime - your synced files stay in the vault, but no new sync runs until you upgrade. See N2O Pro for the full feature breakdown.