Files & storage
Set up Confluence
Connect Confluence to make the company wiki searchable — every page, and optionally blog posts, becomes a document, so “how do we onboard a customer” answers from the page your team already wrote. Cloud and Server/Data Center both work. Read-only.
Before you start
- Cloud: create an API token at id.atlassian.com → Security → API tokens, signed in as the account that should be read as. The token pairs with that account's email.
- Server/Data Center: create a personal access token from your profile instead — no email needed.
- Either way the credential only ever reads; nothing in Confluence is ever changed.
- Documents → Confluence, enter Site — your Cloud address (your-domain.atlassian.net) or your Server/DC base URL.
- Cloud: fill Account email (Cloud) with the token owner's email. Server/DC: leave it blank.
- Paste the token into API token.
- Optionally list space keys under Spaces, one per line — the ENG in your-domain.atlassian.net/wiki/spaces/ENG/… — to sync only those; blank syncs every space the account can see.
- Set Include to Pages only or Pages and blog posts.
- Choose access groups, Test, then Sync.
What comes in
- Every current page in the chosen spaces becomes one document; blog posts come in too when Include is set to both, ranked below pages so a dated announcement never outranks the current page.
- Pages are read as the connected account, so it sees exactly the spaces and pages that account can see.
| Spaces | Optional space keys, one per line. Blank syncs every space the account can see, including personal spaces. |
|---|---|
| Include | Pages only (default), or Pages and blog posts. |
Access
Confluence's own page-level view restrictions are mirrored automatically: a restricted page follows the individual people it's restricted to. A page restricted to a group rather than named people, or with no restrictions at all, falls back to the access groups chosen on the source. Allow-only throughout. Switch How access works to “One list for everything” under Permissions to put everything this source brings in under the chosen access groups instead.
Only pages whose version number moved are re-read on later syncs, so a big old wiki syncs fast after the first pass. Test fails if the site address or token is wrong, or if the account can't reach any spaces at all.
Last updated 20 Sep 2026