How to limit the Confluence Cloud Change History macro (and show child page changes)
Short answer: You can't configure Confluence Cloud's built-in Change History macro. It always lists every version of the current page, with no limit, no child pages and no filters. Atlassian added a limit option on Data Center (CONFSERVER-32315), but the Cloud request, CONFCLOUD-32315, is still open with 392 votes. On Cloud today your options are the page history screen, a Recently Updated macro, or a Marketplace macro.
What the built-in macro does
- Shows each version of the page it's on: version number, author, date and the version comment.
- No 'show the last N versions' setting, so a page with 150 versions gets a 150-row table.
- No child pages: it can't show what changed under a parent page.
Workarounds on Confluence Cloud
- Page history instead of a macro. Open the page, select ••• (More actions), then Page history. Full detail, but readers have to go looking for it, and it's per page.
- Recently Updated macro. Add
/Recently updatedto a parent page and limit it to that space or label. It shows recent edits across pages (including children if you label them), but not version comments, and it's capped by date order, not by page tree. - Put a manual 'last updated' line at the top. Cheap and readable, but it drifts out of date the first time someone forgets.
- Expand macro around Change History. Wrap the Change History macro in
/Expandso the long table is collapsed by default. It doesn't limit anything, it just hides the length. - A Marketplace macro. A few apps add a configurable history table. Check that the app runs on Atlassian Forge and respects page restrictions (it should read versions as the person viewing the page).
FAQ
Can I limit the number of versions in the Change History macro on Cloud? Not with the built-in macro. The limit option exists only on Data Center.
Can the Change History macro show changes to child pages? No. Use Recently Updated scoped to the space or a label, or a Marketplace macro that rolls up child pages.
Does the macro show minor edits? Yes, every version is listed, including edits saved with "Notify watchers" turned off.
Related guides
Disclosure: Loomwise wrote this guide. Not affiliated with Atlassian. Vote counts and ticket statuses are from jira.atlassian.com as of November 2026. Last checked November 2026; Confluence menus and features change, so verify in your site. Contact: hello@loomwise.app