How syncing works

What a sync reads, when it runs, and why the first one is slow.

A sync asks Notion what's there now and redraws the graph to match.

What a sync reads

For every page shared with the integration: its title, the properties needed to build links and run filters, which database it belongs to, and when it was last edited.

It doesn't read the body of your pages, and it never writes anything back.

Full sync and smart sync

For the first run it does a full sync for everything you've shared, from scratch.

After that Graphify does a smart sync: only pages edited since the last run. That's why the first sync can take a long time and the rest take seconds.

Change the structure of a database and Graphify re-reads that database's entries in full, since the change affects all of them.

Syncing is safe to repeat. Running it twice never duplicates nodes, and the graph can always be rebuilt from Notion.

When it runs

On the web

HowWhen
Automatic syncNotion tells Graphify the moment something changes, and the graph updates itself (Pro)
Manual syncWhenever you press it

On desktop

HowWhen
Automatic syncOn an interval you set, in the settings
Sync on launchEvery time you open the app, if you turn it on
Manual syncThe button above the graph, or ⇧⌘R / Shift+Ctrl+R

Only one sync runs at a time, even with several windows open. A running sync can be cancelled.

Pro: Automatic sync driven by Notion webhooks is a Pro feature, and web only. On desktop, syncing happens on a schedule or when you ask for it.

Deleting in Notion

Delete a page in Notion and its node disappears at the next sync. That's intended.

When changes don't show up

Work down this list:

  1. Is the page shared with the integration? In Notion: ••• → Connections. An unshared page is invisible to Graphify.
  2. Is the link a real link? Typing a page's name as plain text creates nothing. Use @, /link to page, or a database relation.
  3. Is the other page shared too? A link needs both ends synced before a line can be drawn.
  4. Still nothing? Run a manual sync.

More in Something is missing.

Still stuck? Tell us what you were doing when it went wrong.

hello@getgraphify.com