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

# Notion

> Connect Notion to track documentation activity and collaboration

Connect Notion to sync your pages, databases, and comments for documentation analytics.

## What's synced

* Pages and their content
* Databases and entries
* Comments on pages
* User attribution for edits and comments

## Connecting Notion

<Steps>
  <Step title="Start connection">
    Go to **Data** and click **Connect** on Notion
  </Step>

  <Step title="Authorize Weave">
    Sign in to Notion and select the pages and databases to share with Weave
  </Step>

  <Step title="Confirm access">
    Review the selected content and authorize the connection
  </Step>
</Steps>

## Access and permissions

### How access works

When you connect or reconnect Notion, you choose which pages, databases, and workspaces Weave can access during the OAuth flow. This selection determines exactly what Weave can see.

<Warning>
  Each time you reconnect the integration, your access selection **replaces** any prior access. Weave will only sync content from your most recent authorization.

  Previously synced data remains in Weave, but new syncs will only include currently authorized content.
</Warning>

### What Weave can access

Weave only requests read permissions:

* **Read pages** — View page content and properties
* **Read databases** — View database structure and entries
* **Read comments** — View comments on pages
* **Read users** — Identify who made edits and comments

Weave does not write to or modify your Notion workspace.

## Updating access

To change which pages or databases Weave can access:

1. Go to **Data** and find the Notion connection
2. Click **Reconnect**
3. Select the new set of pages and databases to share
4. Authorize the updated connection

<Note>
  Reconnecting replaces your previous access selection entirely. Make sure to include all content you want Weave to track.
</Note>

## Metrics enabled

Once connected, Weave tracks documentation activity. See [Documentation metrics](/metrics/documentation) for details on:

* **Doc activities** - Count of page edits and comments (page creates, archives, restores, and edits with no content change aren't counted by default)
* **Doc words modified** - Volume of documentation changes
* **Substantialness ratios** - Proportion of major, medium, and minor changes
* **Technical ratio** - Balance of technical vs non-technical documentation

These metrics help you understand who is contributing to documentation, how substantial those contributions are, and how documentation activity trends over time.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.