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

# Notion troubleshooting

> Notion scope is set at OAuth authorization time, not at the OpenCX source. Most "missing content" issues trace back to the Notion integration's selected pages, not to OpenCX.

Notion scope is set at OAuth authorization time, not at the OpenCX source. Most "missing content" issues trace back to the Notion integration's selected pages, not to OpenCX.

## Common scenarios

| Symptom                                                        | Likely cause                                                                                                                                                   | Fix                                                                                                                                                                                                     |
| -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Expected pages aren't in AI Instructions**                   | During OAuth, you picked **Select pages** and didn't include them                                                                                              | Remove the connection in OpenCX, re-authorize with broader scope, then re-sync. Or, in Notion's own **Settings → Connections**, edit which pages OpenCX can access — the next sync picks up the change. |
| **I shared access to a page but its sub-pages are missing**    | Notion's permission model doesn't cascade shared access to every sub-page automatically; each needs explicit sharing or the parent must grant recursive access | In Notion, open the parent page → **Connections** → ensure the OpenCX integration is added. Sub-pages inherit if the parent grants.                                                                     |
| **Private pages are appearing**                                | Notion's OAuth is based on what you shared at authorization. If "Allow all" was picked, all private pages under that workspace are in scope.                   | Revoke the OpenCX integration in Notion's **Settings → Connections**, re-authorize from OpenCX with a narrower selection.                                                                               |
| **Page edits take hours to show up**                           | Incremental sync on `last_edited_time` — Airbyte's schedule determines the lag                                                                                 | Trigger an immediate sync from the source row in Data Sources. For structural edits (new pages, reorganizations), a full run is triggered next cycle.                                                   |
| **Database rows are synced but I can't query them as a table** | By design — the connector syncs rows as pages for retrieval, not as a queryable table                                                                          | Re-model the database as pages, or use [AI Actions](/actions/introduction) on the Notion API if you need query behavior.                                                                                |
| **None of the above**                                          | —                                                                                                                                                              | Contact support with the connection ID and a sample Notion page URL.                                                                                                                                    |

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Connect Notion" icon="plug" href="/knowledge/sources/notion/connect">
    Re-authorize with different scope.
  </Card>

  <Card title="Notion overview" icon="n" href="/knowledge/sources/notion/overview">
    What this source does.
  </Card>

  <Card title="Training scenarios" icon="rabbit" href="/ai-instructions/training-scenarios">
    Add content the connector can't see.
  </Card>

  <Card title="Connect a knowledge source" icon="brain" href="/knowledge/sources/overview">
    All sources.
  </Card>
</CardGroup>
