Skip to content

Confluence and Notion

WikiFix reads two kinds of source: Confluence sites and Notion workspaces. The Confluence site you installed WikiFix on is connected from the start. An admin can add Notion workspaces and other Confluence sites beside it, and one scan can cover pages from all of them – so a Confluence page and a Notion page that disagree land on the same finding.

You start from WikiFix for Confluence: install WikiFix from the Atlassian Marketplace, then add Notion from its settings.

  1. Open Settings → Apps → WikiFix Admin and go to the Sources tab.
  2. Click Add a source and pick Notion or Confluence.
  3. Sign in on Notion’s or Atlassian’s screen:
    • Notion: choose the workspace and the pages to share with WikiFix. WikiFix reads only the pages you share, and those pages are the most anyone on your team can scan from that workspace. Sharing a page shares the pages under it.
    • Confluence: choose the site. If you choose several sites that aren’t connected yet, you pick one next. The spaces you can open there are the most anyone on your team can scan from it.

The new source shows on the Sources tab with who connected it. Adding sources is for Confluence administrators, the same people who manage WikiFix Admin.

Each person who wants to scan a Notion workspace, or see and fix its findings, signs in with their own Notion account. They then see the pages the connecting admin shared that their own account can also open – no more. A Confluence site added this way works the same, with each person’s Atlassian account. The site WikiFix is installed on needs no sign-in: the app reads it.

Until someone signs in to a source:

  • In the scan picker the source shows locked, with Sign in to … to scan it.
  • On a page’s findings, the ones that involve that source are hidden behind a note – “2 more involve Notion workspace “Acme”. Sign in to it to see and fix them.”

Start a Scan lists every source of your team, each in its own group. In Notion you can tick any shared page or database: ticking it covers everything under it, and a database covers its rows. Tick spaces and pages from as many sources as you like – one scan reads them all.

A finding works the same whichever sources its pages come from. Each page on a card is labelled with its source and opens in Confluence or Notion. Once a team has a Notion workspace, WikiFix calls what you pick to scan collections rather than spaces.

If one source can’t be read during a run – its connection lapsed, say – the scan still covers the others, and the run’s log says which collections it skipped and why.

A scan reads each source as the person who owns it, within what the connecting admin shared. If the owner isn’t signed in to one of the scan’s sources, the scan says Findings in … are on hold: the owner gets a Sign in button, and everyone else is told to ask them.

How each check and action behaves on a Notion page. The checks themselves are described on what a health check covers.

On a Notion pageWhat happens
Pages contradict each otherFound, inside Notion and against Confluence.
Duplicate and near-duplicate contentFound and merged as in Confluence: the page you keep stays, the others become a short notice linking to it.
The page owner has leftNot checked. Notion doesn’t tell WikiFix when someone leaves, so this check runs on Confluence pages only.
Apply and RevertBoth work. WikiFix changes only the blocks the fix touches, so the rest of the page – its comments and formatting – stays as it was. The edit uses your own Notion sign-in.
Ask ownerPosts a Notion comment on the page that mentions the person who created it. Notion attaches it to the page as a whole, not to a passage.
The page badgeConfluence only. Notion pages show their findings in WikiFix.

Some fixes can’t be written to Notion, and WikiFix refuses them rather than writing something close:

  • a change to a block WikiFix can’t recreate – an uploaded file, a child page, a synced block, a bookmark,
  • an edit to a synced copy of a block, which Notion doesn’t allow,
  • a change that would reshape a table, or a callout in a way it can’t hold.

Pages over 20,000 blocks are not scanned.

Notion shows these permissions when you connect:

PermissionWhat it’s for
Read contentReading the pages you share, to scan them.
Update contentUsed only when you apply a fix, merge duplicates, or revert either.
Insert commentsUsed only when you ask an owner to decide – and to take that comment down if you undo it.
Read user information without email addressesNaming a page’s creator, to ask them. WikiFix reads no email address from Notion.

Notion lets an app make about three requests a second, so a large workspace takes longer to read than a Confluence space of the same size. Credits work the same as for Confluence: pages that haven’t changed since the last scan aren’t analysed again.

A source reads through the sign-in of the admin who connected it. If that sign-in lapses or they leave your team, the source shows Needs reconnecting on the Sources tab and only that source pauses; any admin can Reconnect it.

Disconnect stops scans reaching a source you added. Nothing is deleted: its findings and scans stay as they were, and your other sources keep scanning. The site WikiFix is installed on can’t be disconnected – uninstalling the app does that.

  • Getting started – install and your first scan.
  • Security & data – what WikiFix reads and keeps, from Confluence and Notion.
  • FAQ – including whether you can use WikiFix with Notion alone.