Confluence: importing wiki pages for analysis
Connect Confluence Cloud to clariBI with Atlassian sign-in, choose spaces and content types (pages, blog posts, comments, attachments, labels), and ask questions about your documentation.
What you need
- Confluence Cloud (an
atlassian.netsite). Confluence Server and Data Center are not supported. - An Atlassian account that can read the spaces you want to import.
- A free data source slot on your plan.
The Jira and Confluence page in the documentation covers both Atlassian connectors, and the Confluence integration page lists what syncs. Jira has its own help article.
Connect
- Click Data Sources in the sidebar (Settings > Integrations), then Add Data Source.
- Open Apps and choose Confluence.
- Click Connect. On the Atlassian page, pick your site and approve access. clariBI asks only for read scopes (spaces, pages, blog posts, comments, attachments); it cannot change anything in Confluence.
- Back in clariBI, enter a Data Source Name and tick the spaces under Select Spaces.
- Optionally click Customize to choose the content types (all are selected by default).
- Click Create Data Source.
Content types
| Content type | What is imported |
|---|---|
| Pages (Full Content) | Title, body text, labels and metadata such as author and dates |
| Blog Posts | Blog articles with their text and metadata |
| Comments | Page comments with author and time |
| Attachments | File names, types and sizes (not the file contents) |
| Spaces | Space information and settings |
| Labels | All labels used in the selected spaces |
Keeping it current
clariBI reads Confluence again when the data is more than 24 hours old and a report, question or dashboard refresh needs it. To import the latest pages at once, open the source in Settings > Integrations and click Sync Data.
What you can do with it
Confluence content is text, so it is best for questions and summaries:
- "Summarize the decisions recorded in the Engineering meeting notes this quarter."
- "Which project pages mention 'delayed' or 'at risk'?"
- "Which labels are used most in the Product space?"
- "Who created the most pages last month?"
Counts such as pages per month, pages per author or label usage work well as charts. The auto-generated insights dashboard shows these after the first sync.
Removing the connection
Delete the source in Settings > Integrations. To also withdraw clariBI's access on the Atlassian side, remove the app from your Atlassian account's connected apps.
Troubleshooting
No spaces found for this account. The Atlassian account cannot read any space on that site, or you chose another site. Check your Confluence permissions or connect again and choose the right site.
Pages are missing. Personal spaces and restricted pages are only imported if your account can read them. Check the page restrictions in Confluence.
The first import takes long. Large spaces with many pages and comments take a while. Deselect content types you do not need, such as comments or attachments.
If syncing stops after it worked, see sync failures.