> ## Documentation Index
> Fetch the complete documentation index at: https://doc.getrationale.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Notion to import PRD pages into Rationale

> Connect your Notion workspace to search and import pages as PRD sources for any project. Rationale reads pages from any teamspace you authorize.

Connecting Notion lets you pull any page from your workspace directly into Rationale as a PRD source. When you create a project or add a spec to an existing one, you can choose the Notion tab and pick a page from the built-in page picker instead of uploading a file or pasting a link. Rationale searches your authorized teamspaces so you can find the right page without leaving the app.

## What the Notion integration does

<CardGroup cols={2}>
  <Card title="Search and import pages" icon="file-text">
    Browse or search all pages in any teamspace you authorized. Select the page to use as your PRD — Rationale imports the full content.
  </Card>

  <Card title="Any teamspace you authorize" icon="building">
    During OAuth you choose which Notion workspace to connect. Rationale can then read any page shared with the integration.
  </Card>

  <Card title="Keep PRDs in sync" icon="refresh-cw">
    Reference your live Notion pages as the spec source for audits, so your team always works from the same document.
  </Card>

  <Card title="Reuse across projects" icon="layers">
    A connected Notion workspace is available for all projects. Import the same page into multiple projects or use different pages per project.
  </Card>
</CardGroup>

## How to connect

<Steps>
  <Step title="Open Settings">
    Click **Settings** in the left sidebar.
  </Step>

  <Step title="Go to Connections">
    Select **Connections** from the settings menu.
  </Step>

  <Step title="Open the Notion connector">
    Click the **Notion** card.
  </Step>

  <Step title="Add the connector">
    Click **Add connector**. A Notion OAuth window opens.
  </Step>

  <Step title="Authorize your workspace">
    Select the Notion workspace you want to connect and complete the authorization flow. The window closes automatically once the connection succeeds.
  </Step>
</Steps>

## How to import a Notion page into a project

Once Notion is connected, the page picker is available whenever you add a PRD source to a project.

<Steps>
  <Step title="Open the PRD source picker">
    When creating a new project, or when adding a source to an existing project, open the PRD source options.
  </Step>

  <Step title="Choose the Notion tab">
    Select the **Notion** tab in the source picker. The page picker opens automatically.
  </Step>

  <Step title="Search or browse">
    Type to search your pages, or scroll through the list. Click the chevron next to any page to expand and browse its subpages.
  </Step>

  <Step title="Select the page">
    Click the page you want to import. Rationale fetches the full content and uses it as the PRD for this project.
  </Step>
</Steps>

<Tip>
  If a page doesn't appear in the list, open Notion and share that page with the Rationale integration. Pages must be shared with the integration before they are visible in the picker.
</Tip>

## How to disconnect

<Steps>
  <Step title="Open Settings">
    Click **Settings** in the left sidebar.
  </Step>

  <Step title="Go to Connections">
    Select **Connections** from the settings menu.
  </Step>

  <Step title="Open the Notion connector">
    Click the **Notion** card.
  </Step>

  <Step title="Disconnect">
    Click **Disconnect**.
  </Step>
</Steps>

<Note>
  Disconnecting removes the stored access token and revokes Rationale's ability to fetch new pages from Notion. Any content already imported into your projects remains in Rationale — disconnecting does not delete existing project data.
</Note>
