Skip to main content
Connect external documentation sources to pull content directly into your Context pages.
Notion
Import pages and databases using a Notion integration token
Confluence
Browse spaces and pages using your Atlassian email and API token
GitHub
Import markdown, text, and Word files from any accessible repository

Adding an Integration

Admins manage integrations at the tenant level under Admin Settings.
  1. Go to Admin Settings → Integrations
  2. Open Knowledge sources
  3. Find the integration type (GitHub, Confluence, or Notion)
  4. Click Add connection and enter your credentials
  5. Save. Orion validates the connection before storing it
Admin Settings with Integrations selected and the Knowledge sources page open, listing GitHub with a Schema connection, Confluence with no connections, and Notion with a Team Notion connection, each with an Add connection button

Manage knowledge source integrations

Once connected, the integration appears in the list with the connection name and date. Each connection can be renamed (pencil icon), given new credentials (key icon), or removed (trash icon).
Only admins can add integrations. Connected integrations are available to all users for browsing and importing content.

Notion

Setup

Create a Notion internal integration for your workspace, then click Add connection next to Notion in Admin Settings → Integrations → Knowledge sources:
  1. Enter your Internal integration token (starts with ntn_)
  2. Give the connection a name
  3. Save. Orion validates the token before storing it
You must explicitly share each Notion page or database with the integration inside Notion before Orion can access it (Share → Connections → select your integration).

What You Can Import

  • Pages: Imported as markdown with full formatting preserved
  • Databases: Rendered as markdown tables with all visible properties
  • Child pages: Browse into a page to see nested child pages and sub-databases

Browsing

The root level shows all pages and databases shared with your integration. Click into a database to see its rows, or into a page to see child pages.
If a page isn’t showing up, check that you’ve shared it with the integration in Notion’s Connections settings.

Confluence

Setup

Generate a Confluence API token from your Atlassian account, then click Add connection next to Confluence in Admin Settings → Integrations → Knowledge sources:
  1. Enter your Confluence URL (e.g. https://yourcompany.atlassian.net)
  2. Enter the Email associated with your Atlassian account
  3. Enter your API token
  4. Give the connection a name and save

What You Can Import

  • Spaces: Browse all available Confluence spaces
  • Pages: Navigate root pages in a space, then drill into child pages
  • Page content: HTML is automatically converted to markdown on import

Browsing

The root level lists all spaces your token can access. Navigate into a space to see its root pages, then into each page to see children.
Use a dedicated service account token rather than a personal token so the integration doesn’t break if a user leaves the organization.

GitHub

Setup

Create a personal access token with repo scope (or read:org for organization repositories), then click Add connection next to GitHub in Admin Settings → Integrations → Knowledge sources:
  1. Enter your Personal access token (classic ghp_ or fine-grained github_pat_)
  2. Give the connection a name and save

What You Can Import

Supported file types: .md, .txt, .docx
  • Repositories: Browse all repos accessible to your token
  • Directories: Navigate folder structures within a repo
  • Files: Import individual markdown, text, or Word documents

Browsing

The root level lists all repositories the token can access. Navigate into a repo to browse its directory structure and select files to import.
Fine-grained personal access tokens (github_pat_) scoped to specific repositories are recommended over classic tokens for tighter security.

Importing Content

Import from an external source when creating a new page in Context:
  1. In Context, right-click a folder, select New Page, and name the page
  2. On the empty page, click Import
  3. Select the GitHub, Confluence, or Notion tab at the top of the panel
  4. Choose a connection from the dropdown (or click + to add a new one)
  5. Browse the list of pages and select one. A preview loads on the right
  6. Choose an import mode and click to import
Empty Context page named Threshold Alert with the Import panel on the Notion tab, the Team Notion connection, five pages, and a preview of one page, with the Read & Write and Sync Only buttons outlined in red

Import content from an external wiki

Import Modes

When importing, you choose how Orion handles the page going forward: Use Sync Only when the source is the authoritative version and Context should always reflect it. Use Read & Write to import once and then own the content in Orion. A Read & Write page is not linked to its source, so it cannot be synced later.

Syncing Pages

Sync Only pages update automatically, with no manual action required. To refresh one immediately:
  1. Open the page in Context
  2. Open the … actions menu in the upper-right corner
  3. Click Sync now
The page content is overwritten with the current version from the source.

Managing Integrations

From Admin Settings → Integrations → Knowledge sources, each connection has three actions:
  • Rename (pencil icon): change the display name of the connection
  • Update credentials (key icon): replace the stored token. For Confluence, the URL and email can be changed too
  • Remove connection (trash icon): remove the connection. Pages already imported are kept, but they can no longer be synced.