ConnectorsNotion

Connect Notion

Connect Notion, choose the pages to share, bring in existing pages with Import history or the page picker, see how changes arrive, and fix export errors.

Admins only. Gurusup reads only the pages you share with it, and stays up to date as they change.

At a glance

TopicDetails
Who can connectAdmins
What you needA Notion account that can share pages with the app
What Gurusup readsThe pages you share, with their properties
How changes arriveAs pages are created, edited, moved, deleted or restored
Past contentImport history for pages edited in a window, the page picker under Content, page by page while an import runs, or a Notion export
Knowledge accessDefault access, Restricted or Private, chosen when you connect. See Who can read it.

Before you start

  • Decide which pages or sections of Notion Gurusup should read. Gurusup sees only what you share.
  • Decide who should read them in Gurusup. Restricting later only covers what comes next.
  • The same Notion workspace can be connected to several Gurusup organizations, each approving it on its own. See The same account in several organizations.

Connect Notion

Open the Notion connector

In the sidebar, open Sources, then Catalog, find Notion (use Search sources if you need to) and click Connect on its row. Its page opens. Next to Organization accounts, click Connect for the organization. The dialog Connect Notion for the organization opens.

Choose who reads it

Optional. In the dialog, under Who can read it, choose Default access, Restricted or Private from Access mode.

Connect and choose what to share

Click Connect. In Notion, choose the pages or sections to share with Gurusup, then approve. Notion sends you back, and a message says Notion is connected.

Change what is shared

Go through the approval again. Open the Notion page from Sources or Catalog and click Reconnect on the account's row (or Connect for the organization to add another account, then Connect in the dialog). Notion asks again which pages to share.

What Gurusup reads

Gurusup readsGurusup does not read
The pages you shared, and the pages inside themPages you did not share
Page propertiesWhat is inside attachments (images, PDFs, audio, video, files). Gurusup keeps a reference to each.
Links and embeds, kept as links

How changes arrive

Gurusup follows the pages you shared on its own. You do not reconnect or reshare.

Change in NotionWhat Gurusup does
A page is createdReads it
A page's content or properties are editedReads it again
A page is movedReads it again
A deleted page is restoredReads it again
A page is deleted, stops being shared, or Gurusup can no longer open itWithdraws it. What Gurusup learned only from that page goes; what other sources also back stays.

A page that only came from an export, and was never followed by live sync, stays as it was.

Import past work

Gurusup learns from the moment you connect, in setup too. It does not walk everything you shared when you connect: it picks up pages that are created or edited from then on. Pages that already exist and never change do not come in by themselves. You have three ways to bring them in:

WayBest for
Import historyPages edited in the last week to the last year
Choose the pages Gurusup readsPicking pages and databases inside an import that is running
Import a Notion export insteadA large backfill from a ZIP

None of them changes which pages live sync follows or the access you gave in Notion.

Import history by edit date

On Sources, open the Notion page. Under History, click Import history. Pick Last week, Last month, Last 3 months, Last 6 months or Last year. Gurusup goes through what you shared once and brings in only the pages edited in that window. The dialog counts them as a minimum, for example "40+ documents", because Notion's search does not give a full inventory. If nothing matches it says "Nothing to import in this window". Click Import. The message reads "Importing history. It keeps going in the background." When it is done, the row reads "Imported the last" followed by the window and the date.

Choose the pages Gurusup reads

On Sources, open the Notion page. Under Content, the help text reads "Selecting a page includes the page and everything inside it. Databases and tables include all their entries. Uncheck any pages you don't need."

The page picker under Content only brings in pages while an Import history of that Notion account is running, and only pages edited inside the window you picked there. Without a running import, Import selected says "0 pages added. You can follow progress on Home." and nothing is learned. Start Import history first, or use a Notion export.

Find pages

Type in Search pages by title and click Search, or browse. The arrow beside a page or database opens it, and Load more shows more. Refresh list reloads the list. If more than one Notion account approved this connection, the Notion account menu picks which one to browse.

Tick what you want

A ticked page includes the pages inside it. On a database or table the box reads "Select all entries in" and its title, and selects every entry, loaded or not. The counter shows "N selected".

Import

Click Import selected. The button reads "Adding content… x/y", then "N pages added. You can follow progress on Home." The panel closes when every page is accepted. If it fails, the panel stays open with your selection.

If the list reads "No pages found here. Share pages with this Notion connection or try another title. Newly shared pages can take a moment to appear.", share more pages: see Change what is shared.

Import a Notion export instead

The export card is called Import from Notion and sits under History on the Notion page, below Import history. Its text reads "Export Markdown & CSV from Notion with Include subpages, then upload the ZIP file." Each account has its own card: with several Notion accounts, click the account's name first.

Each connection takes one backfill. Once a backfill exists, the form shows its status instead, and there is no way to upload another ZIP, even after it is cancelled, fails or finishes. Check your export before you upload it.

Only admins can start a backfill, and the Notion connection has to be working.

Export from Notion

In Notion, export as Markdown & CSV with Include subpages on. Use your most recent export, and keep the ZIP exactly as downloaded: do not unzip or repackage it.

Open the export form

On Sources, open the Notion page. Under History, find Import from Notion.

Choose the ZIP

Next to Notion export archive ("Use the latest export. Its content replaces previously imported versions of the included pages."), choose the ZIP. Only a ZIP is accepted. Gurusup shows an estimate of the usage and how many files it counted. Files it cannot read are not counted: the line reads "N can't be read and aren't counted".

Confirm and upload

Tick Confirm this export ("This is the latest export from" your Notion workspace), then click Upload and import. The button stays off until you have chosen the ZIP and ticked the box. Gurusup says "Notion export uploaded. Processing continues in the background."

You can leave and come back: the Import from Notion card keeps updating. The upload becomes the baseline for every page in it. Pages Gurusup already holds in a newer version from live sync are not overwritten, and a ZIP identical to one already completed is not imported again.

Why the upload can be refused

Each message follows "Could not upload Notion export." in red.

MessageWhat to do
"Confirm that the export belongs to the workspace shown."Tick the confirmation box.
"Upload the Notion export as a ZIP file."Choose the ZIP as downloaded from Notion.
"This file is empty. Download the export from Notion again."Export again from Notion.
"This Notion export is too large to import (over 256 MB). Export fewer pages and upload it again."The ZIP is over 256 MiB. Export a smaller part of the workspace.
"This Notion export is too large to upload. Export fewer pages and upload it again."Same as above.
"Reconnect Notion before uploading an export."Reconnect first. See Reconnect.
"A Notion backfill is already active for this connection."Wait for it to finish, or cancel it.
"Only organization admins can start Notion backfills."Ask an admin.
"Ingestion is paused for this organization. Ask your organization admin to resume ingestion before adding content." or "Demo Mode prevents changing external sources. Ask your organization admin to turn off Demo Mode to continue."Contact support. See When ingestion is paused or Demo Mode is on.

Follow the backfill

The Import from Notion card refreshes every few seconds while it runs, and Refresh status updates it by hand. A row shows the label, the counts and a badge: Syncing while it imports and Needs attention when it fails. A Coverage row says the archive set a static baseline for the pages it holds. Gurusup does not show the reason under the counts. Every status on every screen is in Processing statuses.

StatusWhat it means
UploadedGurusup has your ZIP.
Validating archiveGurusup is checking the ZIP.
Importing pagesGurusup is bringing the pages in.
CompleteThe backfill finished.
IncompleteSome pages or database rows did not come in. The label adds that a retry is available.
FailedThe backfill failed.
Archive rejectedShown instead of Failed when the problem is the ZIP itself.
Page validation failedShown instead of Failed when a page in the ZIP did not pass.
CancelledYou cancelled it. Pages already accepted are kept.
ButtonWhen it showsWhat it does
Cancel importUploaded, Validating archive, Importing pagesStops it: "Notion backfill cancelled. Accepted pages were preserved."
Retry unresolvedIncomplete or Failed, while Gurusup still has the ZIP"Retry queued for unresolved Notion pages." Gurusup keeps the ZIP up to 7 days, and deletes it once the backfill completes. After that: "This Notion export is no longer stored, so it can't be retried. Upload it again."
Refresh statusAlwaysUpdates the section

Cancel import still works while ingestion is paused. Retry unresolved and the upload buttons do not.

The counts read like "12 accepted · 3 deduplicated · 0 stale ignored · 0 unresolved · 0 failed · 15 pages".

CountMeaning
acceptedPages Gurusup took in from the export
deduplicatedPages identical to what Gurusup already held
stale ignoredPages where Gurusup already had a newer version
unresolvedDatabase rows that could not be matched to a page. Not imported.
failedPages that failed because of a problem on our side. The others still imported.
pagesPages found in the export
data-source rowsWith databases, "matched/total", for example "8/8 data-source rows"

CSV files of databases are not counted as pages. Under the counts, Gurusup says the export set a baseline for those pages and live sync takes over page by page as Notion reports changes. Imported pages are part of your memory once learned: follow them on Follow ingestion.

Gurusup does not show in the app why a backfill ended as Incomplete, Failed, Archive rejected or Page validation failed. Click Retry unresolved while the app offers it. If that does not help, contact support with the Notion account name and the time of the upload.

Export limits and rejected exports

Gurusup checks the ZIP before importing it.

LimitValue
ZIP size as uploaded256 MiB
Size once unzipped1 GiB in total
Files in the export100,000
One file64 MiB
Folder depth32 levels
One file name1,024 bytes
CompressionFiles that expand more than 200 times are refused

A failed check shows Archive rejected, Page validation failed, or Failed for database problems. Gurusup deletes a rejected ZIP, so there is nothing to retry. To upload a corrected export, contact support with the Notion account name and the time of the upload.

Who can read it

What Gurusup learns from one Notion workspace is one source, and its access covers every page, imported or synced.

Knowledge accessWho reads it in Brain
Default accessEveryone, according to what they are already allowed to see: admins every category, members and agent accounts the categories an admin granted them.
RestrictedOnly the people you pick. Administrators are not included unless you pick them.
PrivateOnly you. Administrators are not included.

To change it later, open the Notion page and change Access mode under Knowledge access; it saves as soon as you change it. Restricting later only covers what comes in after that. See Restrict a source to specific people.

Check that it worked

Change a page

Add a sentence to a shared page in Notion.

Follow it

Open Ingest and pick the Notion source in the filter. The change moves to Learned. Total memories on Sources goes up.

Check a backfill

If you uploaded an export, wait for Complete and check the counts add up to the pages you expected.

Reconnect

If the account's status reads Needs reconnect, click Reconnect on its row under Organization accounts and approve again. To connect a second Notion workspace, click Connect for the organization again on the Notion page: each workspace is its own source with its own backfill, and the two share one Notion row on Sources. See One row per app.

Disconnect

On Sources, open the Notion page. Under Danger zone, open the menu on Disconnect, choose Disconnect and confirm. A dialog titled "Disconnect [name]?" says "Gurusup stops reading from Notion. What it already learned stays." Click Disconnect again to confirm, or Cancel. It removes the whole connection and deletes the credentials Gurusup stored for your organization, but does not revoke the approval in Notion: to remove the Gurusup app from the workspace, do it in Notion, which also cuts off any other organization that connected the same workspace. What Gurusup learned stays. A connected Notion source has no Remove source. See Remove, disconnect and what stays.

If it does not work

CheckWhat to do
A page is missingCheck it is shared with Gurusup in Notion. Then import it with Import history if it was edited recently, or choose it with the page picker under Content while that import runs.
"The Notion connection changed while you were signing in. Refresh the page and connect again."The connection was changed while you approved. Refresh the page, then connect again.
An export was refused or rejectedSee Why the upload can be refused and Export limits and rejected exports.
Buttons are offIngestion is paused or Demo Mode is on. See When ingestion is paused or Demo Mode is on.

For failed approvals and empty sources, see Connector troubleshooting.