Mappings

A mapping connects folders on your computer to a Notion page or database. NotionGate watches the folders and keeps Notion up to date when files are added, renamed or deleted.

Page or database?

  • - Page mapping: every file is written as a link into the text of one Notion page, one line per file. Click a link in Notion and the file opens on your computer. Best for notes pages, course pages and anything you also write in.
  • - Database mapping (Pro and Team): every file becomes its own entry in a Notion database, with its name, a link, the created and modified dates and its size. Best when you want to sort, filter or tag files.

To split one large folder into one page per subfolder automatically, use Smart Mappings.

Before you start

  • - Your Notion token is saved under Settings, Notion Integrations (see First-Time Setup).
  • - Your integration has access to the target page or database. Without access the mapping cannot be saved or syncs nothing.
  • - Copy the link of the target: in Notion open the page or database, then ... menu, Copy link.

Create a page mapping

  1. 1. Open Mappings in the sidebar.
  2. 2. Choose Add new mapping, then Page mapping.
  3. 3. Paste the Notion page link (or its ID) into the Notion field.
  4. 4. Optional: enter a mapping title. Left empty, NotionGate takes the page title from Notion.
  5. 5. Optional: enter a group such as 3. Semester, or pick one you already use.
  6. 6. Add folders: pick them with the folder button or paste paths, one per line.
  7. 7. Optional: set exclusions and options (explained below).
  8. 8. Choose how files appear in Notion: Global setting or Own format.
  9. 9. Choose Create mapping. NotionGate adds links for the files that are already there and then watches the folders.

Create a database mapping

  1. 1. Open Mappings and choose Add new mapping, then Database mapping.
  2. 2. Paste the link of the database itself (a full-page database, or open an inline database as a page first).
  3. 3. Add folders, exclusions and options as for a page mapping, then Create mapping.

NotionGate adds the properties it needs to the database if they are missing (such as the link, dates and size) and leaves your other columns alone. Database mappings need Pro or Team.

The mapping editor, field by field

Target

  • - Notion page or database: link or ID of the target. Required.
  • - Mapping title: the name shown in the app. Fetched from Notion when left empty.
  • - Group: sorts the mapping into a collapsible section of the list. Smart mappings set it for you.

Folders

  • - One or more folders whose files are synced. At least one is required.
  • - On Basic, every folder counts towards your mapped-folder limit and each folder may hold up to 10 files.

Exclusions

  • - Exclude file endings: for example .log or *.tmp. NotionGate suggests endings found in your folders, and offers common ones (PDF, Office files, images and more) to add with one click.
  • - Exclude specific files: exact file names or paths to skip, comma or one per line. Pick them with the file button.
  • - Exclude folders and patterns: subfolders or name patterns to skip, such as node_modules or a backup folder.

Options

  • - Full lifecycle sync (rename/delete): a renamed file gets its link updated, a deleted file's link is removed.
  • - Sync newly created files automatically: new files are added as soon as they appear. Off means only files present when you sync.
  • - Include files in subfolders: also syncs files in nested folders.
  • - Use folder links (open Explorer): links open the folder that holds the file instead of the file itself.

How files appear in Notion (page mappings)

  • - Global setting: the mapping uses the format from Settings, Link appearance. Change it there once and every mapping that uses it follows. See Settings.
  • - Own format: block type (line, bullet or to-do), link text and text after the link for this mapping only. It starts from the global format.
  • - Placeholders: {name} file name, {stem} name without extension, {ext} extension, {folder} folder name, {date} and {time} last modified, {size} file size.
  • - Changes apply to links added from then on and to links that get renamed; existing links stay as they are. A renamed to-do keeps its tick.

Managing mappings

  • - The list has tabs for Page mappings, Database mappings and File links, with counts.
  • - Mappings with a group appear under that group, which you can collapse. NotionGate remembers which groups you collapsed.
  • - Edit opens the editor with the current settings. Save changes applies them.
  • - The switch turns a mapping on or off. A mapping that is off is kept with all its settings but does not sync.
  • - Delete mapping, at the bottom left of the editor, removes the mapping. Tick Also remove its links from Notion to delete the links it wrote on the page (or move its database entries to the Notion trash). Text you wrote yourself stays, and links that another mapping still syncs are kept.
  • - If you close the editor of a new mapping before saving, the draft is kept and comes back the next time you choose Add new mapping.
  • - Dashboard, Sync now syncs all page mappings immediately.

What happens when files change

  • - New file: added to Notion, if Sync newly created files automatically is on.
  • - Renamed or moved within the mapped folders: the link is updated, if Full lifecycle sync is on.
  • - Deleted: the link or database entry is removed, if Full lifecycle sync is on.
  • - Text you write yourself on the Notion page is never changed.
  • - Changes made while NotionGate was closed are caught up when it starts: new files are added, links to moved files are pointed at the new place, links to deleted files are removed. If very many links of one mapping look dead at once (for example because a cloud drive is still syncing), NotionGate leaves them and Health lists them instead.
  • - Links to a folder that is not reachable, such as a cloud drive that is not mounted, are never removed.
  • - Every change is listed under Activity in the sidebar. See Usage.

Plan limits

  • - Basic: page mappings only, up to 3 mapped folders and 10 files per folder. The app shows how much is used.
  • - Pro and Team: database mappings, no folder or file limits.
  • - When a limit is reached, the editor tells you before saving.

When something does not sync

  • - Open Health in the sidebar. It lists pages your integration can no longer open, folders that are missing and whether the file watcher runs.
  • - Notion says the page was not found: give your integration access to it again (see First-Time Setup, step 3).
  • - A file is missing: check the exclusions and, on Basic, the 10-files-per-folder limit.
  • - Keep folder paths stable. If you move or rename a mapped folder, edit the mapping and pick the new path.