Docs → Evergreen
Evergreen docs
Evergreen checks Confluence Cloud spaces for orphaned pages, broken links, links that still point at your old Confluence server, and stale pages. Site admins use it from Confluence administration, space admins from Space settings, and every page shows its own link issues in the page byline.
Getting started
Before you install
- Confluence Cloud.
- A Confluence site admin to install the app and choose which spaces are scanned.
- Space admin permission to open Evergreen's page in a space's Space settings.
Install and first use
- Install and open EvergreenInstall Evergreen from the Atlassian Marketplace, then open Evergreen from the apps section of Confluence administration. Your first visit starts the first scan on its own, in the background.
- Choose your spacesClick Settings and pick spaces under Spaces to scan. On the free plan you can choose up to 3; if you choose none, Evergreen scans the first 3 spaces. On Standard, leave it empty to scan every space.
- Add your old server address (optional)If you migrated from Confluence Server or Data Center, enter the old host (for example
wiki.example.com) under Old Confluence server address(es). Links to it are flagged as old-server links. Server-style links such as/display/…orviewpage.actionto any non-Atlassian host are flagged even without this. - Set the stale threshold and schedulePick Stale after (30, 60, 90, 180 or 365 days) and Re-scan automatically (Weekly, Daily on Standard, or Off). Click Save and re-scan.
- Read the reportWhen the scan finishes, the report lists orphaned pages, broken links, old-server links and stale pages per space. Badges compare each count with the previous scan. Click Scan now any time for a fresh scan.
- Check pages and spacesEvery page in a scanned space shows Links OK or N link issues in its byline; click it to see the links. Space admins open Evergreen in Space settings to see and work on their own space's report.
- Ask RovoIf your site has Rovo, open the Evergreen Content Hygiene agent or ask Rovo chat Which pages in this space have broken links? It answers from the latest scan: pages with broken links and their targets, orphaned pages oldest first, and a space summary. It only shows pages you can see and never changes anything.
Configuration
What Evergreen checks
- Orphaned pages: pages with no parent page and no inbound link from any scanned page or blog post (page links, page-id links, pasted URLs and smart links count; links from a page to itself do not). Space homepages are never orphans.
- Broken links: page links whose target page no longer exists in a scanned space, page-id and short
/x/links to pages that are gone, and links to attachments that are missing from their page. - Old-server links: hard-coded links to your old Confluence server, shown with the Cloud page each one should open.
- Stale pages: pages not edited for at least the number of days you set.
- External links: counted per host as an inventory. They are never visited.
- Both pages and blog posts are read. Blog posts are link sources only, so they are never listed as orphans.
Site admin page (Confluence administration)
The Evergreen page in Confluence administration holds the settings (spaces, old-server addresses, stale threshold, schedule), the Scan now button and the full report. Only the site admin decides which spaces are scanned.
On Standard it also has Export CSV (orphans, broken links, old-server links and stale pages) and the fix actions below.
Space admin page (Space settings)
Space admins open Evergreen in their space's Space settings to see that space's orphaned pages, broken links, old-server links and stale pages from the last scan. Every action there checks that the user administers that space.
A space admin can start a scan of the spaces the site admin chose, but cannot change which spaces are scanned. If the space is not in the scan, the page says so and asks the site admin to add it.
Fixing links and orphans (Standard)
- One-click fixes: re-point links to pages that moved, and rewrite old-server URLs to their Cloud pages.
- Find and replace link targets in bulk, as plain text or regex, with an optional Match case. On the free plan you can preview the matches; Standard applies them. Site admins work site-wide, space admins in their own space.
- Re-home an orphaned page under a New parent page, or archive orphans (up to 100 per archive action).
- Pages are only changed after an admin clicks to apply a fix.
Page review (Standard)
In Space settings, a space admin can set a Review cycle (30, 60, 90, 180, 365 or 730 days). Pages not edited within it are listed as due for review with their owner (Confluence's page owner, else the last editor, else the creator).
Remind owners with a page comment is off by default. When on, Evergreen posts one footer comment per page per review cycle that @mentions the owner. Reminders run at most once a day and post at most 50 comments per run; the rest wait for the next run.
Language
Available in English, German, French and Spanish. The app follows each person's Confluence language setting; Rovo answers, exports and comments the app posts stay in English.
Free vs Standard
Plans and prices below are read from the same pricing file the app uses. Atlassian bills per user per month on your site's user tier, and the price per user steps down at larger tiers. See all pricing.
Free
Free
- Orphaned pages — not under any parent page and linked from nowhere, across spaces in one view
- Broken links of every kind — page links, pasted Confluence URLs, smart links, page-id and tiny links, missing attachments
- Hard-coded links to your old Confluence server after a migration, with the Cloud page each one should point to
- Stale pages — threshold you choose (30 to 365 days)
- Pages and blog posts both checked; each page shows its own link issues under the title
- Space admins get their own report in Space settings; preview find-and-replace of links
- Choose the 3 spaces to scan; weekly background re-scan with a since-last-scan summary; runs on Atlassian (no data egress)
Standard
$0.15 / user / month
Free for sites up to 10 users. 30-day free trial.
- Scan every space in the background — up to 100,000 pages per scan
- Daily scheduled re-scans
- One-click fixes — re-point links to pages that moved, rewrite old-server URLs to their Cloud pages
- Find and replace link targets in bulk (plain text or regex), preview first, site-wide or per space
- Space admins apply fixes in their own space
- Re-home an orphaned page under a parent, or archive it
- Page review per space (e.g. every 180 days): pages past it listed with their owner; optional reminder comment @mentioning the owner
- CSV export of orphans, broken links, old-server links & stale pages
Limits
- Free plan: up to 3 spaces, chosen by the site admin. Standard: every space (up to 500 spaces per scan).
- Free plan: weekly or manual scans. Standard adds daily scans.
- Up to 25,000 pages per space and 100,000 pages per scan. A space that reaches the cap is flagged as possibly incomplete, because orphan and broken-link results need the full page set.
- Up to 500 links read per page.
- Each list in a space report shows up to 100 rows; the counts are exact. The page byline shows up to 10 issues per page.
- Up to 20 old-server addresses in settings.
- Find-and-replace: find text up to 200 characters, replacement up to 500 characters.
- External links are counted, not visited, so a dead external URL is not reported as broken.
Data & privacy
What Evergreen stores
- Everything is kept in Forge hosted storage for your site. The app declares no external servers, so no data leaves Atlassian.
- Settings: chosen spaces, old-server addresses, stale threshold and schedule.
- Scan progress, plus compact page records while a scan runs (page id, title, parent and link targets). Page bodies are never stored.
- The report: per-space lists of orphaned pages, broken links, old-server links and stale pages (page ids, titles, link targets and counts), and a small per-page record of link issues for the byline.
- Page review: each space's review cycle and reminder setting, and for each reminded page the review cycle it was reminded for. Page owners are read live from Confluence and never stored.
Evergreen runs on Atlassian Forge. Data it stores sits in Forge hosted storage for your site, which Atlassian pins to your product's region. See Trust & security, the Privacy Policy and the DPA.
Permissions (scopes)
| Scope | Why Evergreen needs it |
|---|---|
read:space:confluence | List spaces so you can choose which to scan. |
read:page:confluence | Read pages and blog posts to find their links, parents and last-edit dates. |
write:page:confluence | Standard: apply link fixes, find-and-replace and orphan re-homing, only after an admin clicks. |
read:attachment:confluence | Check that linked attachments still exist. |
read:content.metadata:confluence | Standard: archive orphaned pages. |
write:comment:confluence | Standard, off by default: post one page-review reminder comment per page per review cycle. |
storage:app | Save settings, scan progress and the report in Forge hosted storage. |
FAQ & troubleshooting
Why is this page flagged as orphaned?
It has no parent page in the page tree and no scanned page or blog post links to it. Links from spaces that are not in the scan do not count, so on the free plan a page linked only from an unscanned space can show as orphaned. Space homepages are never flagged.
Does Evergreen check external links?
No. External links are counted per host but never visited, because Evergreen has no access to the internet outside Atlassian. Only internal links are checked: page links, pasted Confluence URLs, smart links, page-id and short /x/ links, and attachments.
How often does it scan?
The first scan starts when a site admin first opens Evergreen. After that it re-scans weekly by default, daily on Standard, or only when you click Scan now if you set Re-scan automatically to Off. Scans run in the background, so you can leave the page.
The page byline says Evergreen hasn't scanned this space. Why?
That space is not in the scan. On the free plan Evergreen scans 3 spaces the site admin chooses. A site admin can add the space under Settings → Spaces to scan, or upgrade to Standard to scan every space.
I fixed a link but the report still shows it. Why?
Links you edit by hand appear fixed after the next scan. Click Scan now to refresh. Fixes applied through Evergreen update the page's byline record straight away.
What does "Part of your site wasn't scanned" mean?
A space reached the page cap (25,000 pages per space, 100,000 per scan), so the results may be incomplete. Pages linked only from pages that were not read can look orphaned, and links to them can look broken.
Does Evergreen change my pages?
Only when an admin on Standard applies a fix, a find-and-replace, a re-home or an archive. Page-review reminder comments are only posted if a space admin turns them on. Detection on its own never edits pages.
Can space admins choose which spaces are scanned?
No. Only the site admin chooses spaces, in Evergreen's settings in Confluence administration. Space admins can see their own space's report and start a scan.
Changelog
Every release and what changed: Evergreen changelog.
Getting help
Email support@datadir.co with your site URL and what you saw. Our target is a first response within 1 business day. See Support for what to include, and Status for known issues.