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
| Topic | Details |
|---|---|
| Who can connect | Admins |
| What you need | A Notion account that can share pages with the app |
| What Gurusup reads | The pages you share, with their properties |
| How changes arrive | As pages are created, edited, moved, deleted or restored |
| Past content | Import history for pages edited in a window, the page picker under Content, page by page while an import runs, or a Notion export |
| Knowledge access | Default 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 reads | Gurusup does not read |
|---|---|
| The pages you shared, and the pages inside them | Pages you did not share |
| Page properties | What 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 Notion | What Gurusup does |
|---|---|
| A page is created | Reads it |
| A page's content or properties are edited | Reads it again |
| A page is moved | Reads it again |
| A deleted page is restored | Reads it again |
| A page is deleted, stops being shared, or Gurusup can no longer open it | Withdraws 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:
| Way | Best for |
|---|---|
| Import history | Pages edited in the last week to the last year |
| Choose the pages Gurusup reads | Picking pages and databases inside an import that is running |
| Import a Notion export instead | A 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.
| Message | What 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.
| Status | What it means |
|---|---|
| Uploaded | Gurusup has your ZIP. |
| Validating archive | Gurusup is checking the ZIP. |
| Importing pages | Gurusup is bringing the pages in. |
| Complete | The backfill finished. |
| Incomplete | Some pages or database rows did not come in. The label adds that a retry is available. |
| Failed | The backfill failed. |
| Archive rejected | Shown instead of Failed when the problem is the ZIP itself. |
| Page validation failed | Shown instead of Failed when a page in the ZIP did not pass. |
| Cancelled | You cancelled it. Pages already accepted are kept. |
| Button | When it shows | What it does |
|---|---|---|
| Cancel import | Uploaded, Validating archive, Importing pages | Stops it: "Notion backfill cancelled. Accepted pages were preserved." |
| Retry unresolved | Incomplete 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 status | Always | Updates 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".
| Count | Meaning |
|---|---|
| accepted | Pages Gurusup took in from the export |
| deduplicated | Pages identical to what Gurusup already held |
| stale ignored | Pages where Gurusup already had a newer version |
| unresolved | Database rows that could not be matched to a page. Not imported. |
| failed | Pages that failed because of a problem on our side. The others still imported. |
| pages | Pages found in the export |
| data-source rows | With 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.
| Limit | Value |
|---|---|
| ZIP size as uploaded | 256 MiB |
| Size once unzipped | 1 GiB in total |
| Files in the export | 100,000 |
| One file | 64 MiB |
| Folder depth | 32 levels |
| One file name | 1,024 bytes |
| Compression | Files 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 access | Who reads it in Brain |
|---|---|
| Default access | Everyone, according to what they are already allowed to see: admins every category, members and agent accounts the categories an admin granted them. |
| Restricted | Only the people you pick. Administrators are not included unless you pick them. |
| Private | Only 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
| Check | What to do |
|---|---|
| A page is missing | Check 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 rejected | See Why the upload can be refused and Export limits and rejected exports. |
| Buttons are off | Ingestion 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.