Can you limit how many page versions Confluence Cloud keeps?

By Kayabyte · Updated 17 November 2026

Short answer: Not with a built-in setting. Confluence Cloud keeps every version of every page and attachment, and there is no option to keep only the newest N versions; the request for one, CONFCLOUD-27701, was still Gathering Interest when checked on 1 November 2026. The native ways to cap history are to delete versions one at a time from the page history, or to script the REST API and run the script again whenever history grows back. For a standing “keep the newest N versions” rule across spaces, with a preview and an optional nightly run, Pruner: Version History Cleanup for Confluence is an app I make.

Disclosure: I make Pruner. The built-in options come first, and nothing before the Pruner section needs an app.

If your pages have hundreds of versions, you have probably looked for a “maximum versions” setting. This guide says what exists in Confluence Cloud, what a cap would have to do, and where each option stops.

What Confluence Cloud does today

Option 1: delete versions by hand

  1. Open the page and open its page history.
  2. Select Delete next to a version you no longer need and confirm.

Deleted versions don’t go to the trash and can’t be restored, and version numbers can change after a delete. If you don’t see Delete, ask a space administrator. Deleting a specific attachment version needs the Space Administrator permission. This is one version of one page per click. Details are in How to delete old page versions in Confluence Cloud.

Option 2: a script on the REST API

A script can list the pages in a space, list each page’s versions and delete all but the newest ones with DELETE /wiki/rest/api/content/{id}/version/{versionNumber}. It is the closest thing to a cap that needs no app. Where it stops:

What a cap on versions needs

Whatever you use, decide these first:

Pruner: Version History Cleanup for Confluence

Pruner applies that policy to Confluence Cloud.

Limits: deleted versions can’t be restored, Confluence renumbers the remaining versions, and Confluence updates its storage figure on its own schedule, usually within a few hours. Page text versions are small, so the storage you free is mostly attachment versions.

Pruner is on the Atlassian Marketplace. Moving from Data Center? See Purge Versions for Confluence in Cloud, and for other apps, Confluence version cleanup apps compared.

Not a Confluence admin? Send this to yours

Only an admin can install apps. Copy this note and send it to yours:

Could we try Pruner? Delete old versions of Confluence pages and attachments, keep the newest ones, preview what goes first, and free up storage. Nightly clean-up is optional. It is on the Atlassian Marketplace and built on Atlassian Forge, and it makes no calls outside Atlassian. Free for up to 10 users. Listing: https://go.kayabyte.dev/atl/pruner?s=site-ask-confluence-limit-page-versions

FAQ

Is there a setting to keep only the last N versions of a Confluence Cloud page? No. Confluence Cloud keeps every version, and the request for a limit, CONFCLOUD-27701, was still Gathering Interest when checked on 1 November 2026.

Can I limit versions for one space only? Not with a setting. You can delete versions in that space by hand or with a script, or use a retention policy app that lets you choose the spaces.

Can I undo deleting a page version? No. Deleted versions aren’t restorable, so preview or dry-run first.

Does deleting old versions free storage? For attachment versions, yes, and Confluence updates the storage figure on its own schedule. Page text versions are small.

Will Pruner delete the current page? No. The current version and the page content are never changed, and the newest versions you chose to keep are always kept.

Confluence and Atlassian are trademarks of Atlassian. Kayabyte is an independent developer and is not affiliated with or endorsed by Atlassian.