Skip to content

Configuration reference

There isn’t much to configure. This page is the reference for the handful of things you do set, split by who does them:

  • Monitoring & scanning — the day-to-day controls: which spaces and Notion pages you watch, how often, the digest, in-app notifications, and the scan-completion email. Anyone who can run scans manages these.
  • Admin console — the install-time and instance-wide settings an instance admin manages in WikiFix Admin: the sources WikiFix reads, the permissions granted at install, and your edition and bring-your-own-key.

For the loop these settings drive, see How it works.

These are the operational controls — what you reach for as you watch your spaces and act on findings.

You monitor a set of spaces by configuring them on the monitoring dashboard: pick the spaces, and choose how often WikiFix scans them.

FieldWhat it does
SpacesThe spaces, and Notion pages, to watch. There’s no “all spaces” mode; you pick them explicitly, and a scan never reads outside them. Ticking a Notion page covers the pages under it.
FrequencyDaily, Weekly, or Monthly for a scheduled watch; Manual keeps the space on the board but only scans when you start it.

You can also start an ad-hoc scan — a saved scope you re-run on demand — from the Scans tab. The form takes a name and the spaces to scan, grouped by source; one scan can cover several sources. Every scan runs every check, and starts out on demand; you can give it a schedule afterwards from the scan’s own settings.

The "Start a scan" dialog: a Scan name field, and a space picker listing each space with its page count, a note that scans cost credits for the new and changed pages they analyze, and a running "1 of 16 selected · ≈ 502 pages" total.

The space picker shows each space’s page count and an always-on note that scans cost credits for the new and changed pages they analyse. If your selected spaces add up to more than 10,000 pages, it raises an advisory warning — large scans can consume a lot of credits. The warning never blocks you; it suggests tightening scope or splitting into separate scans.

A scheduled watch runs on its own. A background dispatcher checks for due scans every few hours and starts any that are due; after a scheduled run finishes, the scan becomes due again one day (daily), seven days (weekly), or thirty days (monthly) later. Manual and on-demand scans only run when you start them.

A scheduled run is skipped silently if none of its sources can be read as whoever set it up — their Confluence authorization lapsed, say, or their Notion sign-in did. The scan stays due and runs on the next sweep once they sign in again. A scan that covers several sources runs as long as one of them can be read.

WikiFix runs one scan at a time for your team, across all its sources. If you start more, the extra runs queue and start in order as the running one finishes — first started, first served. A queued run shows as queued, not running, until its turn comes.

Every page carries a WikiFix item in its byline, under the title. It reads “No issues” with a green check, “N issues found” with a red badge, or “Not yet scanned” in grey when the page hasn’t been analysed at its current version — recomputed each time the page renders. That third state matters: a page WikiFix hasn’t read yet never gets a clean bill of health it hasn’t earned.

Ask owner is a per-finding action, not a scan-wide setting. Choosing it posts a Confluence comment anchored to the passage in question and @mentions the page’s owner and the space’s admins. WikiFix resolves each role to people still active on your site at that moment, so a departed or unlicensed person is never @mentioned. On a Notion page it posts a comment on the page that mentions the person who created it; Notion delivers the notification. A finding with pages in both asks each owner in their own tool, and if any comment can’t be posted, none are.

It hands the decision over rather than nudging: the finding leaves your active list for the Escalated tab and stays there until someone settles it. There’s no automatic version of this — it’s always a deliberate, per-finding choice.

If the passage changed since the scan, nothing is posted and WikiFix asks you to re-scan, so a comment never points at text that’s already gone.

How WikiFix emails you after a scan depends on how the scan was triggered:

  • A scheduled daily, weekly, or monthly watch sends a digest — the running total of open issues, how that’s changed since the last scan, a per-space breakdown, and a link to the dashboard. A quiet scan still sends an All clear.
  • A manual or on-demand scan sends a completion notice instead — the scan name, the number of new issues, and a link to the Scans tab.

Either way, only the person who set the scan up is emailed, and there’s nothing to configure: the email is sent on every terminal outcome.

You get an email when a scan finished, failed before finishing, stopped because credits ran out, or was stopped (aborted) before finishing.

Two things have to be in place for any of these emails to send:

  • The app needs the email-address permission on your site. The read:email-address:confluence scope is granted at install. Until a site consents to it, the owner’s address can’t be looked up and the email is skipped (the scan itself is unaffected).
  • The owner needs an email address Atlassian will return. If the account is gone or Atlassian holds no address, there’s nothing to send to and the email is skipped.

When an email can’t be sent, WikiFix records why on the run and moves on — a missing email never affects the scan or its findings. The address is resolved at send time and never stored; the run log records that an email went out, not where. The start-a-scan form warns you upfront if your own address can’t be resolved.

These are the install-time and instance-wide settings. They live in WikiFix Admin and are managed by a Confluence instance admin, not by everyone who runs scans.

WikiFix Admin opens on Get Started, a short checklist. Beside it, Sources lists the Confluence sites and Notion workspaces WikiFix reads, and is where you add, reconnect or disconnect one — see Confluence and Notion. Permissions sets which Confluence groups can run scans, launch monitoring, and see scans other people started; LLM, Residency, Edition, and Telemetry follow. Confluence administrators always have full access and never appear in the permission lists.

The Permissions tab in WikiFix Admin: a note that Confluence administrators always have full access, a group picker, and a grid granting Run Scans, Launch Monitoring and See all scans — with "Everyone (all authenticated users)" granted the first two.

Your Confluence admin grants these Confluence scopes once, at install. A Notion workspace asks for its own, narrower set when it’s connected — see Confluence and Notion. They’re declared in the Forge manifest, which is public on the Marketplace listing, so you can verify the list rather than take our word for it.

ScopeWhat it’s for
read:confluence-space.summary, read:space:confluenceList and read the spaces you scope a scan to.
read:page:confluenceRead page content during a scan.
write:page:confluenceUsed only when you apply a fix — rewriting page content, or updating the owner on a departed-owner finding.
read:comment:confluence, write:comment:confluenceUsed only when you ask an owner to decide — that posts a regular Confluence comment.
delete:comment:confluenceUsed only when you undo asking an owner — that deletes the comment WikiFix posted, and no other.
read:content.metadata:confluenceRead a page’s metadata. Confluence requires it alongside write access for its page-archive endpoint.
read:content.permission:confluenceTell a deleted page from one the person running a scan can’t open, so findings on a page that no longer exists close.
read:user:confluence, read:group:confluenceResolve who owns a page, who has left, and a user’s group membership (so group-based permission grants match the right people).
read:content-details:confluenceRecognise which users are Confluence admins, so admins aren’t misdetected as ordinary users.
read:email-address:confluenceResolve the address of whoever set the scan up, to send the digest or completion email. Addresses are fetched at send time and never stored.
read:app-system-token, read:app-user-tokenLet the app’s backend authenticate its own calls. They grant no additional access to your content.
storage:appLet the WikiFix agent in Rovo keep one pending summary per person, until they settle the finding it belongs to.

Three things bound what any scan can reach: the spaces and Notion pages selected (a scan never reads outside them); what its owner can open; and the app’s own authorization — the scopes above, which your admin can restrict further with Atlassian’s app-access controls, and in Notion the pages the connecting admin shared.

For where your data lives and what’s stored versus processed transiently, see Security & data.

The Edition panel in WikiFix Admin shows your current edition (Standard or Advanced) and the credits each dollar buys on it, with a link out to Atlassian to change it. WikiFix never processes the edition change itself — you self-switch on Atlassian’s side, and this panel catches up within a few hours. See Editions & plans for what each edition includes and the step-by-step upgrade.

On the LLM tab, a paid Advanced tenant can add a bring-your-own-key Anthropic API key, so the AI work runs on the tenant’s own Anthropic account instead of drawing down scan credits — both scanning and the apply-time rewrite that authors a fix. A toggle controls whether scans spend remaining credits first and fall back to the key, or use the key exclusively. Standard tenants see an upgrade prompt here instead, as do tenants still inside Atlassian’s 30-day evaluation.

  • How it works — monitoring, the digest, ad-hoc scans, and the page experience.
  • Editions & plans — Standard vs Advanced, the trial, and how to upgrade.
  • Credits & capacity — what a credit buys, plan allowances, the trial, and bring-your-own-key.
  • Security & data — what’s stored, what’s processed transiently, and where it lives.
  • FAQ — the questions we expect.

Anything these don’t answer: support@wikifix.ai.