/
User guide

User guide

Welcome to FreshPage! 🍋

FreshPage is the content trust and AI readiness engine for Confluence. With the rise of AI-driven search like Atlassian Rovo, keeping your wiki accurate, owned, and up-to-date is more important than ever. FreshPage acts as a safety firewall, ensuring that both your team and Rovo are only fed high-quality, verified data.

This guide covers:

  1. Understanding the Trust Engine (Banner & Byline)

  2. Verifying Pages & Managing Exclusions

  3. Evergreen Pages

  4. Space AI Readiness Dashboard (Trust Center)

  5. Trust Manager (Bulk Actions & Ownership)

  6. Content Trust Overview Macro

1. Understanding the Trust Engine

Every page in a FreshPage-enabled space displays a status banner at the top and a detailed status card in the page byline.

FreshPage dynamically calculates a page's Trust Status using real-time signals (owner presence, owner status, age since last verification, draft/archived status, and edit history).

The Three Trust States

  • 🟢 TRUSTED

    • Meaning: Verified recently, has an active owner, and has not been modified since the last verification.

    • AI Readiness: Suitable for AI consumption. Rovo will search and cite this page.

  • 🟡 NEEDS_REVIEW

    • Meaning: The page was edited after it was verified, the verification has expired, or the page has no active owner assigned.

    • AI Readiness: Not Suitable. Rovo is prevented from using this page in AI answers (if excluded).

  • 🔴 UNSAFE

    • Meaning: The page has never been verified, is a draft/archived page, or has exceeded your space's critical staleness threshold.

    • AI Readiness: Not Suitable / Suppressed. Shielded from Rovo AI search results.

2. Page-Level Actions: Verifying & Rovo Toggles

Directly from the page byline, users and owners can manage the trustworthiness of any document.

How to Verify a Page

If a page is showing Needs Review or Unsafe (yellow or red banner):

  1. Review the content to ensure it is accurate and up-to-date.

  2. Click Mark as Fresh (or Verify) in the byline panel.

  3. The page status updates to Trusted (green) with your name and timestamp.

    image-20260622-044205.png

Revoking Verification

If you notice that a page contains errors, you can click Revoke verification in the byline. This immediately marks the page as Unsafe (or Needs Review), prompting the owner to update and verify it again.

image-20260622-044253.png

 

Toggling Rovo AI Search Exclusion

Want to keep a page hidden from Rovo regardless of its freshness?

  1. Open the page byline.

  2. Toggle Exclude from AI to ON.

  3. The AI Suitability status will immediately show Excluded, shielding it from Rovo search.

    image-20260622-044317.png

Requesting a Review

If you aren't the page owner but notice the page is out of date:

  1. Click Request review in the byline.

  2. FreshPage will automatically send a review reminder to the assigned owner.

    image-20260622-044333.png

3. Evergreen Pages

Some pages (like company templates, core values, or static reference guides) never go stale.
To mark a page as Evergreen:

  1. Click the Labels icon at the bottom right of the Confluence page.

  2. Add the label: freshpage-evergreen

  3. The page will immediately change to Trusted (green) and display an "Evergreen" badge. It will never expire or require manual verification.

4. Space AI Readiness Dashboard (Trust Center)

The Trust Center (AI Readiness Dashboard) provides space administrators and team leads with a high-level overview of the space's documentation hygiene.

To access the Trust Center:

  1. Click Trust Center in the page byline panel, or navigate to Space Tools / Space Apps → FreshPage Report.

  2. Hygiene Metrics: See cards for Total Pages, Trusted for AI, Needs Review, Unsafe for AI, Verified, and Expiring Soon.

  3. Pages Needing Attention: View and filter pages that need immediate review (Needs Review, Unsafe, Expiring Soon) along with the reasons (e.g., "Verification expired", "Content modified after verification", "Deactivated owner").

  4. Force Recalculate: Click Recalculate Trust Status to run a fresh scan across the entire space.

    image-20260622-044531.png
    Space Apps action
    image-20260622-044503.png
    Dashboard

5. Trust Manager (Bulk Actions & Ownership)

To perform bulk maintenance, space administrators can use the FreshPage Trust Manager dashboard.

Access via: Space Settings → Apps → FreshPage Manager (or click the tabs at the top of the Trust Center).

Features:

  • Hierarchical Page Table: Displays all space pages in a nested, indent-aligned hierarchy.

  • Smart Filtering: Filter pages by Trust Status (All, Trusted, Needs Review, Unsafe) and Owner Status (Active vs. Deactivated / Inactive).

  • Bulk Verification: Select multiple pages using checkboxes and click Mark X Pages as Fresh to verify them all at once.

  • Bulk Owner Assignment: Select ownerless pages, pick a user from the user picker, and assign them as the page owner in bulk.

  • Deactivated Owner Remediation: Easily find pages whose owners have left the company (Inactive) and reassign them to active team members.

  • Trigger Bulk Reminders: Select pages needing attention and click Notify Owners. This posts a reminder comment on the pages, tagging their owners.

    image-20260622-044622.png

6. Content Trust Overview Macro

Embed the Content Trust Overview macro on your space homepage or dashboard to show a summary card view of the space's trust stats.

  1. In edit mode, type /FreshPage or insert the Content Trust Overview macro.

  2. The macro displays a clean, visual card summary showing the count of Trusted, Needs Review, and Unsafe pages in the space.