BlueGrove Labs
Help CenterCompare Any Two PagesConfluence Cloud
Support
中文

Compare a Confluence Page with a Reference

Use Compare with another page in the Page changes macro to show how the current page differs from a standard, template, or related document. Readers can review those differences without selecting the two pages themselves.

In this example, Release readiness standard is the reference and Aurora release readiness is the current page. The reference requires two reviewers; Aurora requires three and adds a 24-hour notice period. The comparison highlights those differences. It does not decide whether a difference is acceptable or change either document.

Configure the reference

  1. Edit the page that should display the comparison: Aurora release readiness in this example.
  2. Insert Page changes, or select an existing macro and choose Edit. See Add the macro.
  3. Select Compare with another page.
  4. In Reference page (Before), search by title, paste a Confluence URL, or enter a content ID. Select the intended result.
  5. Choose Follow latest or Fixed version for the reference.
  6. Optionally enable Show the full comparison on the page by default.
  7. Select Save, then publish or update the Confluence page.
Page changes settings with Compare with another page selected, Release readiness standard as the reference, Fixed version pinned to version 1, Aurora release readiness identified as this page, and the default expansion option below
Select Compare with another page, then choose the reference and its version strategy. This page (After) is filled in from the page containing the macro.

The current page is selected automatically; there is no second page picker in the macro settings. The reference must be a different supported page, blog post, or Live doc on the same Confluence site. It may be in another space if the reader can access it.

Follow updates or pin a version

Reference setting What happens Suitable for
Follow latest Each page load resolves the reference’s newest available version. Checking against a standard that is maintained over time.
Fixed version The reference keeps the numbered version selected when the settings are saved. Reviewing against a particular release or milestone.

When using Fixed version, selecting Latest version still saves the current number. For example, saving Latest version while the reference is at v1 pins v1 even after v2 is published. To keep following updates, select Follow latest instead.

The current page uses its latest readable published or saved content when the card loads. Expanding a card or opening its comparison uses that card’s resolved versions; it does not check for another update. Reload the Confluence page to load a new pair. Live doc saves do not always create separate history versions.

Review the differences

The card shows the reference name, its version strategy, the current page, and the number of differences. Select Expand to read inline or View differences to open the full comparison.

An expanded reference comparison in Unified view showing the two page titles, a swap button, change navigation, and highlighted reviewer and rollback requirements in a table
Unified view keeps the checklist in one reading area. Removed words are struck through and additions are highlighted; the page names show the comparison direction.

Choose Unified for one combined reading area or Side by side for two panes. Use Previous change and Next change to review the highlights. In Side by side, Sync scroll keeps the two panes aligned.

The macro compares the whole body of both pages. Its own Page changes macros and settings are excluded, and the result explains that exclusion when applicable. Other supported page content remains part of the comparison.

No differences found means both pages were compared successfully without a difference; readers can still open that result. An inaccessible reference or version produces an unavailable message, not a zero-difference result.

Swap the comparison direction

The default direction is reference → current page. Select the arrow button between the page titles, Swap before and after pages, to read the same pair in reverse. Additions and removals then describe the opposite direction.

  • In the expanded macro, swapping is available in both Unified and Side by side.
  • In the full comparison window, switch to Side by side to show the swap button.
  • Swapping keeps the resolved versions. It does not fetch a newer version or change the saved reference.
  • Switching reading modes retains the current direction. Collapsing and reopening the inline result resets it to the macro’s direction.

Opening View differences starts from the macro’s saved direction, even if the inline view was reversed. Within that window, Restore macro comparison resets a temporary version or direction change. Closing and reopening the window also restores the original pair. See Temporarily inspect other versions.

Share or save a review

Open View differences to access version selectors, sharing, and Export → Export PDF. A share link refers to the actual numbered versions and reading mode, so it does not become a moving Follow latest comparison. Recipients need access to both pages.

The inline result does not have version selectors, sharing, or export controls. Confluence’s own page export is not a saved interactive comparison. See Read comparison results for the full workspace controls.

Fix an unavailable comparison

Situation What to do
The reference cannot be opened Check that you can open it directly in Confluence. Ask the page owner for the required access or choose another reference.
A fixed reference version is unavailable Edit the macro and choose an accessible version. The macro will not silently replace the chosen version.
The reference is the same page as the current page Choose a different reference. Use a baseline mode to compare versions of one page.
A copied page still uses the original reference This is expected: the reference remains selected while This page becomes the new page. Review the settings after copying.
Copying the macro onto its own reference makes it invalid Select a different reference on the destination page.
You want to compare two other pages Open the app page and choose both sides there. The macro always uses the page containing it as After.

Screenshot