Usage

Everything in NotionGate happens in the desktop app. The sidebar on the left leads to Dashboard, Health, Activity, Mappings, Smart Mappings, Help and Settings.

A typical workflow

  1. 1. Save your Notion token and give your integration access to the pages you want to fill (First-Time Setup).
  2. 2. Choose how links should look once, under Settings, Link appearance (Settings).
  3. 3. Create a mapping for each folder and its Notion page (Mappings), or split a large folder with Smart Mappings.
  4. 4. Work as usual. New, renamed and deleted files show up in Notion by themselves.
  5. 5. If something looks wrong, open Health.

Dashboard

  • - Status: whether the backend runs and Notion is connected, plus a one-line health summary that links to Health when something needs attention.
  • - Sync now syncs all page mappings immediately. Open Notion opens your workspace.
  • - Numbers: mappings, mapped folders against your plan limit, linked files and file links.
  • - Your mappings, each with a button to open its Notion page.

Health

Tests your account, the Notion connection, access to every mapped page, the mapped folders, the file watcher and disk space, and says what to fix. Restart sync starts the file watcher again. Details in Health Checks.

Activity

  • - A list of everything NotionGate changed in Notion, newest first and grouped by day: files added, renamed and removed, links repaired and mappings deleted.
  • - Filter by kind to see, for example, only removed links.
  • - It updates by itself while the page is open. Clear empties the list; nothing in Notion changes.
  • - The last 500 changes are kept on your computer.

Mappings

  • - Page mappings: files become links in the text of a Notion page.
  • - Database mappings (Pro and Team): every file becomes a database entry.
  • - File links: a link to a single file you paste anywhere in Notion. See File Linking.
  • - Add new mapping, Edit and the on/off switch for every mapping; mappings with a group are shown in collapsible sections.

Smart Mappings

Splits one large folder, such as a semester, into one Notion page or database row per subfolder and creates the mappings for you. The page lists every set you created. Details in Smart Mappings.

Help

This documentation inside the app. It is loaded from notiongate.app and kept on your computer, so it also works offline. Report a bug is at the top of the page.

Settings

Account, license and devices, the Notion token, link appearance, application behaviour, backup and transfer, updates and bug reports. Every tab is explained in Settings.

Running in the background

  • - Syncing runs as long as NotionGate runs, also when the window is closed to the tray (Windows) or menu bar.
  • - Closing the window minimizes it by default. Under Settings, Application you can choose to be asked or to quit completely; after quitting, nothing syncs.
  • - Start with Windows (Start at login on Mac) and Start minimized make NotionGate run without you thinking about it.

Basic plan limits

  • - Up to 3 mapped folders, 10 files per folder and 10 file links. The app shows how much you use.
  • - Database mappings are available on Pro and Team.