Import from Notion, Google Docs and Confluence

If your guidelines live in Notion, Google Docs or Confluence, you can import a page straight from there, without exporting it. Groundrule fetches the one page you choose, turns it into Markdown with its headings, and reads it exactly like an uploaded document: you see the estimate, AI proposes the rules, and each proposal cites the page.

Before you start

• An admin connects the app in Settings → Connections. See Connected apps. Admins and platform admins can connect and disconnect apps; standard owners can use them.
• AI is on for the workspace (Settings → AI).
• You have an authoring role: admin, platform admin, or standard owner.

When an app shows “Not set up on this deployment”, it isn’t available yet.

Each app gives Groundrule read-only access:

App	What Groundrule can read	How you find a page
Notion	“Search pages you’ve shared with the Groundrule integration.” Only pages shared with the integration	Search by title
Google Docs	“Paste a document’s link. Groundrule can read documents, not browse your Drive.”	Paste the link
Confluence	“Search pages by title across the Confluence site you choose.”	Search by title

Pages are read only when someone imports them.

Import a page

1. Open Inbox → Import a document, and choose From an app.

   From an app appears only when at least one app is connected.

2. Pick the app, if more than one is connected. The App list shows each one as “app · account”.

3. Find the page.

   • Notion and Confluence: type in Search Notion or Search Confluence. Results update as you type, up to 20 pages, most recently edited first. With nothing typed, you see the most recently edited pages.
   • Google Docs: paste the link into Document link, such as https://docs.google.com/document/d/…. “the account must be able to open it.” The document appears once the link resolves.

4. Select the page and choose Continue.

5. Review the estimate, then choose Find rules. See Import documents for every field of the estimate.

You should see the page in the Documents section of the inbox as “From Notion”, “From Google Docs” or “From Confluence”. Its title links back to the page. When reading finishes, its proposals are in the inbox, each citing the page title and the heading it came from.

If it goes wrong:

• “No pages found. In Notion, share pages with the Groundrule integration first.”: in Notion, share the page with the integration, then search again.
• “That link didn’t open a document.”: check the link, and that the connected Google account can open it.
• “App didn’t allow access to this document. Share it with the connection and try again.”: the connected account can’t read that page.
• “App needs to be reconnected.”: the connection’s access expired or was revoked. In Settings → Connections it shows Needs reconnecting. An admin connects it again.
• “App is rate-limiting requests. Try again in a minute.”
• “This Notion page is too long to import. Import its sub-pages instead.”, “This Confluence page is too long to import.”, or “This document is too long to import.”: import smaller pages.

What is imported

App	What becomes the document
Notion	The page title, then its blocks: headings, paragraphs, lists, to-dos, quotes, callouts, toggles, code and tables, up to 4 levels of nesting and 5,000 blocks. Sub-pages and databases inside it are not included; import them on their own
Google Docs	The document, including all its tabs, with headings kept
Confluence	The page title and body, with headings kept

From there it is a document like any other: the same limits, passages, citations, cost estimate, and deletion of the text once reading ends. See Import documents.

Disconnecting

An admin can choose the bin icon next to a connection in Settings → Connections, then Disconnect. “Groundrule will stop reading from this app account and delete its access. Proposals and standards already imported stay, with their citations.” Where the app supports it, Groundrule also revokes the access at the app.

How Groundrule protects connection tokens is in How Groundrule protects your code.