Connect Synaps to Confluence
Synaps runs inside Jira and reads its dependency data directly. To publish a dependency map to Confluence, a site admin connects the Synaps app to Confluence once. After that, anyone can publish straight from the Export dialog. Here is how to set it up and confirm it worked.
This is only needed for the Confluence export. Every other Synaps feature works in Jira with nothing to set up.
01. Before you start
You need two things:
- Confluence in your Atlassian Cloud. If your organisation does not have Confluence yet, an Atlassian admin can add it.
- A Jira or organisation admin to make the connection. A regular project member cannot connect the app, but everyone can publish once it is connected.
02. Connect the app to Confluence
Installing Synaps on Jira does not give it access to Confluence on its own - even when both products live on the same Atlassian site. A site admin grants that access once, from the same place apps are installed and managed in your Atlassian admin, by connecting Synaps to Confluence.
One-time setup: once an admin connects Synaps to Confluence, it stays connected. Users never see the connection step again.
Until that is done, the Confluence option in the Export dialog is disabled and Synaps reports that Confluence is not connected.
03. Check it worked
Open the Export dialog from the navbar and look at the Confluence option:
- Enabled - you are connected. Pick a space, optionally a parent page, and publish.
- Greyed out - not connected yet, or you have no Confluence space you can write to. See the table below.
04. Troubleshooting
If the Confluence export is unavailable, Synaps tells you why:
| What Synaps says | What it means | How to fix it |
|---|---|---|
| Confluence isn't connected | The app has not been connected to Confluence | Ask a site admin to connect Synaps to Confluence (step 2) |
| No accessible Confluence space found | The app is connected, but you cannot write to any space | Get write access to at least one Confluence space |
| Cannot reach Confluence | A temporary network problem | Try again in a moment |
Once the Confluence option is enabled, Export and share covers how to publish, name, and place the page.