Change History Macro

This macro is available in Confluence Server and Data Center. Learn about the macros available in Confluence Cloud.

Add the Change History macro to a page to display a table of recent updates to that page including version number, author, date and version comment. 

This macro is great for:

  • document control 
  • change management
  • wiki gardening and keeping your pages fresh.

On this page:

Screenshot: The Change History macro in Confluence showing two history versions.

For general information about version control in Confluence, see Page History and Page Comparison Views.

Add the Change History macro to your page

To add the Change History macro to a page:

  1. From the editor toolbar, choose Insert > Other Macros.
  2. Choose Change History from the Confluence content category.
  3. Choose the number of page versions to display. 
  4. Choose Insert

You can then publish your page to see the macro in action. 

Screenshot: configuring the Change History macro in the macro browser.

Change the macro parameters

Macro parameters are used to change the behaviour of a macro.

To change the macro parameters:

  1. In the editor, click the macro placeholder and choose Edit.
  2. Update the parameters as required then choose Insert.

Here's a list of the parameters available in this macro. 





Number of versions to display



Limit the amount of page history to display. Leave blank to display all versions in the page history.

Other ways to add this macro

Add this macro as you type

Type followed by the start of the macro name, to see a list of macros. 

Add this macro using wiki markup

This is useful when you want to add a macro outside the editor, for example as custom content in the sidebar, header or footer of a space.

Macro name:  change-history

Macro body: None.


Last modified on Mar 31, 2023

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.