Page Changes and Space Changes header image
documentation

Page Changes and Space Changes

Use Confluence page and space versions to track changes and organize your versions of your content.

page-history.png

Page Changes

Each time you submit a change on a Confluence page, it creates a new version of that page. For each page, you can view the  page history to track all versions of that page and view the changes made between each version. This makes it possible for your team to see who made what changes to the page, and is great for managing versions of content as you can revert any changes if needed.

page-history.png

page-version-comparison.png

To make it easier to understand the changes made in each page version, add a note in the "What did you change?" note area before submitting the page. These notes display for each version in Page History. You can use apps like Engineering Essentials to make this note required before page submission.

Space Changes

Confluence page versions are very handy for viewing changes made to individual pages over time, but when writing documentation, it's important to also track and manage changes to entire collection of content – like in a Confluence space.

For example: When product version 1.0 is released, your team will need to maintain the documentation for the released version 1.0 as well as create documentation for the upcoming product version 2.0 which builds on the initial 1.0 documentation. Not to mention documentation for a bug fix in 1.1.

Teams need a way to manage changes to multiple pages within a space and control whether they are included in a larger version. This is especially useful when writing documentation for a product, which has new versions released over time.

There are a few different ways to manage changes to an entire space, depending on how your team writes documentation.

To get started, there are a few approaches you can use within Confluence:

For more options and functionality, you can use Confluence apps to enhance the experience:

Embed comments

Next Up...

If your team makes a product that's always on the latest version, such as a SaaS app, it may be less important for users to have access to older versions of your documentation.

documentation
Steffen Burzlaff Steffen Burzlaff

Scroll Documents enhances Confluence Cloud by enabling your team to manage and version your documentation collaboratively.

documentation
Steffen Burzlaff Steffen Burzlaff

Expanding the functionality of page versions in Confluence Server and Data Center, the Scroll Versions app introduces the concept of true space versions.

documentation
Steffen Burzlaff Steffen Burzlaff

Another approach to versioning is to use a single space for both authoring new documentation and publishing released documentation.

documentation
Steffen Burzlaff Steffen Burzlaff
Share this article
Reset Cookies

The following services will be reset and deactivated for you.

  • Typeform:
    We're using Typeform to embed quizzes and surveys into our website. By clicking "Disable all services" you're no longer able to submit quizzes or surveys on our website until accepting the service again.
  • Hyvor Talk:
    We're using Hyvor Talk as a comment tool. Hyvor Talk sets a local storage when activated. By clicking "Disable all services" you're no longer able to post or read comments on our website until accepting the service again.

By clicking "Disable all services" all cookies and local storages related to the services will be removed. Before using them on our website again, you need to accept them.