Greenlight for Confluence — Documentation

Greenlight adds lightweight page approvals to Confluence Cloud: a status on the page byline, an Approve button for the right people, an automatic reset when content changes, and an optional lock after approval. It runs entirely on Atlassian Forge — no data leaves the Atlassian cloud.

How it works

1. A space admin turns Greenlight on for a space and sets who approves and the policy.
2. An author enables approval on a page; the assigned approvers click Approve right on the byline.
3. If the page is edited after approval, the status flips to Changed automatically — re-approval keeps it current.

Setup (space admins)

Open Space settings → Apps → Greenlight settings, then:

• Approver mode
  • Fixed — one set of approvers for the whole space.
  • Per page — page editors choose the approvers on each page.
• Approvers (Fixed mode) — pick the people who can approve.
• Policy
  • All approvers must approve, or
  • Any one approver.
• Lock after approval (optional) — protect a page from casual edits once it's fully approved.

Using Greenlight on a page

• Enable approval — open the Greenlight item in the page byline and turn approval on (in Per-page mode, set the page's approvers there).
• Notify approvers — approvers are nudged with a native @mention comment (the Confluence bell). No email setup.
• Approve — assigned approvers click Approve in the byline. The status shows Pending, Approved, or Changed after approval, with who approved and when.
• Automatic reset — editing an approved page past its approved version flips the status to Changed. The status is recomputed from the page's live version, so it never drifts out of sync.
• Lock / unlock — when the lock is on, an approved page is protected from casual edits; click Unlock to edit to release it. Space admins and the page owner can always edit, and any edit flips the status back to Changed.

Space report

A per-space report lists every page with an active approval status — Pending, Approved, or Changed — sorted with the pages that need attention first. Open it from the space's apps.

Permissions & data

Greenlight stores only the minimum it needs — Confluence page and space IDs, the account IDs of approvers, and approval events — in Atlassian Forge storage. It does not read page body content, uses no third-party services, and sends no data outside Atlassian. See the Privacy Policy and Security Statement.

Good to know

• Greenlight works on classic Confluence pages (live-doc support is on the roadmap).
• Approvals are lightweight workflow metadata — not legally binding e-signatures, and not intended for regulated or GxP use.

Support

Questions or issues? Email akvola.bean.cg@gmail.com.