Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

How do you handle documentation change management?

I'm curious how folks manage changes of formal docs/standards in Confluence. I know the page history is there, but that poses a number of challenges. 1) it tracks every single time a page is saved, which won't help in identifying overall policy changes. and 2) it would require a diligent approach to documenting what was changed (since the "what did you change?" field cannot be made required when editing a page). I'm looking for a way to document the big changes, like the versioning on a document that states date of change, what was changed, who changed it, and who approved it. We have previously used simple tables to capture this information, but I'm curious if there is a better way to do this. Perhaps with a macro I'm unaware of. 

Thanks in advance for any insight you can provide into the best and most efficient way to formally manage document changes!

2 answers

2 accepted

2 votes
Answer accepted

Hello @Emily Urbanski , welcome to the community!

As you say, Confluence does save a version for every page edit, but that this can make it difficult to track the major changes. While I cannot think of macros available in Confluence natively that will help, as @Matt Reiner _K15t_ indicates, there are many apps on the Atlassian Marketplace that may help you manage your document changes.

One of your options could be Comala Document Management, the app allows you to create workflows to manage your document lifecycle. This could include reviews, different document stages, publishing or automated change record tables. If you want to learn more about Comala Document Management, please check out our webinars.  

All the best

Senior Product Manager

Thank you, James! I will add this to the list to review with stakeholders. Appreciate your response!

Like James Conway _Appfire_ likes this

You are welcome @Emily Urbanski!

If you or your stakeholders have any specific questions, do not hesitate to contact our Customer Success team at 

All the best


1 vote
Answer accepted
Matt Reiner _K15t_ Marketplace Partner Jun 17, 2021

Hi @Emily Urbanski

1. Perhaps my team's app Scroll Documents would be a partial solution here. While it still tracks individual changes and activities, it enables you to version a whole collection of pages together, and to view the changes made across all of them.

2. I believe there is an app on the Marketplace (that I can't find🤦🏻‍♂️) that requires users fill out the "What's changed?" Field before saving. This could make the page history much more valuable.

Thank you, Matt! This could certainly be an option for us. Appreciate the response!

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Apps & Integrations

Apps for Confluence you won't want to miss: RSVP for September's Appy Hours

Calling all collaborators and Confluence users! Our Appy Hours event on September 29th features 4 presenters demoing functionality to superpower Confluence. Don't miss learning about these apps i...

117 views 0 9
Read article

Atlassian Community Events