1. Docs
  2. Administration
  3. Integrations
  4. Confluence

Confluence

The Confluence integration writes SmartestQA content into Confluence Cloud: one page per finished run under a reports page, and one page per test case under a documentation page.

4 min read Updated CustomersAdmins

In short

On this page you can

  • Create a Confluence page for every finished run that has no page yet.
  • Create a report page automatically when a pipeline finishes.
  • Export every test case as a documentation page, and update it later.
  • Change the parent page of each category directly on the page.
  • Open or delete the links between SmartestQA items and Confluence pages.

How to use it

  1. Create an Atlassian API token and find the space key and parent page IDs.
  2. Click Setup, enter URL, email and token, then Test Connection.
  3. Enter the Default Space Key and the parent page IDs.
  4. Choose the sync features, turn on Enable Integration and save.
  5. Click Send Report and open the new page in Confluence.

Before you start#

  • Confluence Cloud. The integration uses the Confluence Cloud REST API with email and API token.
  • An API token for a technical Atlassian account, from Atlassian account › Security › API tokens. The dialog links to it with Create API Token.
  • A space key, for example QA, where that account can create pages.
  • Parent page IDs. Create one page for reports and one for documentation. The ID is the number in the page URL: in …/wiki/spaces/QA/pages/123456789/Test+Reports it is 123456789.

Set up Confluence#

  1. Connection Settings

    Click Setup. In Confluence Integration Configuration enter Confluence URL (for example https://your-site.atlassian.net), Email and API Token. Click Test Connection.

    Connection Successful. Next works only after this.

  2. Space & Pages

    Enter the Default Space Key and under Parent Page ID Settings the Reports Parent Page ID and Documentation Parent Page ID. Requirements Parent Page ID is for requirement import, which the page does not offer yet.

  3. Sync Settings

    Under Sync Features turn on Test Reports Sync and Documentation Sync. Turn on Auto-Create Report Pages to get a page after every pipeline. Keep Enable Integration on and click Save.

    “Confluence settings saved” and the page shows Active.

What is sent and when#

ActionWhat happens in ConfluenceNeeds
Send ReportFor every finished run of the project that has no page yet under the current reports parent page, one page is created. Runs still running are skipped.Test Reports Sync
A pipeline finishesOne report page for that run.Test Reports Sync and Auto-Create Report Pages
Send All Test Case DocsOne page per test case under the documentation parent. A test case that already has a page gets that page updated, and moved if you changed the parent.Documentation Sync
Requirements ImportShown as Coming soon, with no button. An AI assistant can still start it; see Requirement import.The card’s switch on and a Requirements Parent Page ID

A report page is titled pipeline - yyyy-MM-dd HH:mm [last 8 characters of the run id]. If Confluence already has a page with that title, SmartestQA adds “ (2)”, “ (3)” and so on. When nothing is new, the message reads “No new reports to send (total: n reports, mapped: m, running: r)”.

Only one sync runs at a time per project. A second one gets “Zaten bir senkronizasyon devam ediyor” (a sync is already running, shown in Turkish in this version). A sync that has held the lock for 60 minutes is released.

Changing the reports parent page

“Already sent” is counted per parent page. If you point Reports Parent Page at a new page, the next Send Report publishes every finished run again under the new parent. Use that to rebuild a report tree; avoid it on a project with hundreds of runs.

Requirement import#

The page offers no requirement import yet: the Requirements Import card shows Coming soon instead of a Pull Requirements button. The server can import, and an AI assistant connected through MCP can start it (smartest_integrations, sync with target requirements). Turn on the card’s switch and set its parent page first. Each child page of the Requirements Parent Page ID becomes a main requirement (title and text) in a Confluence Import folder of Analyze; a page imported before updates its requirement.

The Confluence page#

  • KPIs: Total Mappings, Test Cases, Test Reports, Requirements. See how they are counted.
  • Connection Status: Confluence Integration (Synchronization enabled or disabled), Confluence Space, Last Sync.
  • Synchronization tab: one card each for Requirements Import, Test Reports and Documentation. Each card has its sync switch and its parent page, which you change with Edit and save in place. The Test Reports card also has Auto create reports.
  • Mappings tab: sections Test Case, Test Report and Requirement, with search, Open in Confluence and Delete Mapping.

Switches and parent page edits save at once; a failure shows “Update failed”. Deleting a mapping only removes the link; the page stays in Confluence, and the item gets a new page on the next send.

Remove asks “Are you sure you want to remove the Confluence integration? All mappings will be deleted.” Pages in Confluence stay.

If something goes wrong#

Didn’t find your answer?Write to support with your project name and what you see on screen.

info@smartestqa.ai
© 2026 Selenity Technology · SmartestQAsmartestqa.aiThis page as MarkdownChecked against smarttest-fe predev 2a8c79cc, smarttest-be 633c2a03 (ConfluenceSyncService, ConfluenceApiService, TestLogsServiceImpl afterCommit hook)