Connect Confluence Cloud and BeforeQuery indexes your spaces — engineering runbooks, product specs, onboarding guides — alongside your public docs. Every answer that uses Confluence content cites the exact page.

​
Prerequisites

  • A Confluence Cloud site (e.g. acme.atlassian.net).
  • An Atlassian account with read access to the spaces you want indexed — a dedicated service/bot account is recommended so the connector doesn’t break when a teammate leaves.
  • A BeforeQuery workspace owner role.

​
Data ingested

When you connect Confluence, BeforeQuery indexes, for each page:
  • Page URL — what citations link back to
  • Page title
  • Page body as markdown — headings, lists, tables and code blocks
Content is read from Confluence’s stored page source, so macros are not expanded: a page whose content comes from a macro indexes as empty. Attachments are not fetched.

​
Set up the connector

1

Create an Atlassian API token

Sign in as the account the connector should use and create an API token at id.atlassian.com → Security → API tokens. Copy it — you’ll need the token and the account’s email address.
2

Add the source in BeforeQuery

In the dashboard, open your Knowledge Base → Sources, click Add source, and choose Confluence. Fill in:
  • Site URL — your Confluence base URL, e.g. https://acme.atlassian.net
  • Email — the Atlassian account email
  • API token — the token from step 1
  • Space key (optional) — index a single space (e.g. DOCS); leave empty to index every space the account can read
3

Start the first sync

Click Add. Pages are fetched, converted to markdown, chunked, and embedded. Track progress on the source card and browse the results under Documents.

​
Connection settings

​
Keeping content in sync

Confluence re-syncs every 10 minutes — there is no schedule to configure, and Sync on the source’s page runs one now if you cannot wait. Only changed content is re-embedded. See Sources Overview.

​
Troubleshooting

  • A space isn’t being indexed? The connector account can’t read it — grant the account access in Confluence space permissions, then sync again.
  • 401/403 errors during sync? The API token expired or was revoked. Create a new token and update the source settings.
  • Too much indexed? Set a space key to limit indexing to one space, or split spaces across multiple Confluence sources and organize them with source groups.
  • Keeping wiki content internal? Mark the documents restricted so they answer only for workspace members, never for public widget users.