Documentation for Confluence 5.8 (Server).
Documentation for Confluence Cloud and earlier versions of Confluence is available too.

Skip to end of metadata
Go to start of metadata

The Change-History macro shows the history of updates made to a page: version number, author, date and comment. It displays the information inline.

Screenshot: The Change-History macro in Confluence

To add the Change-History macro to a page:

  1. In the Confluence editor, choose Insert > Other Macros
  2. Find and select the required macro

Speeding up macro entry with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Using Autocomplete.

To edit an existing macro: Click the macro placeholder and choose Edit. A macro dialog window will open, where you can edit the parameters of the macro.

Note: There are no parameters for this macro.

Code examples

The following examples are provided for advanced users who want to edit the underlying markup for a Confluence page. 

Macro name:  change-history

Macro body: None.

Parameters: None.

Storage format example

Wikimarkup example

  • No labels


  1. Anonymous

    Hi there!

    Is there any possibility to restrict the amount of list items? Like showing only the current version and its precursor, even if there are more than two changes made?

    Something like "change-history|list=2" ?

    Best regards,


  2. Anonymous

    Like Sascha I would like to display only the current page version, is this possible?

  3. Anonymous

    Same as both above, I'd like to limit this

  4. Anonymous

    Agreed - it provides all 27 versions - its going to eat up the page really fast, in fact it already has. Please provide a way to display a certain # of revisions

  5. Anonymous

    same as all above. I want only selected commits to show up! please do something!

  6. I would also like to be able to select, for example, "the last 10 updates" of the page, where "10" can be set as a parameter of the macro...

  7. Anonymous

    Ditto - going crazy with revisions, I need to only show the latest x on the page.

  8. Anonymous

    Another highly desirable parameter: "Show only commented versions".

  9. Agree, this definitely needs to have a limiting option..

  10. Anonymous

    Agreed. Need additional parameters for this macro to control amount of information displayed.

  11. Anonymous

    Is there any workaround for the length problem? Like a scrollable frame or something? Alternative plugin?

    Joachim, Sensor Developments 

  12. Anonymous

    Hey guys,

    Try this:

    With version-history:first=10 for example.


  13. Anonymous

    Just replace {change-history} with comment

    To see "change history", select Tools -> "Page History"

  14. Anonymous

    I also agree. This is a must have …

  15. Anonymous

    I agree with the above; something like version-history with the addition of a restriction based on only showing versions with comments would be ideal.


  16. Anonymous

    Important link (for template developers)  is missing in now in menu, it is Confluence Wiki Markup for Macros.

  17. Anonymous

    is it possible to only show a set of changes (with their version numbers and a link to that version) based on the comment content, or a label, or some page meta data?

  18. Anonymous

    I can only agree with all of the above comments. I cannot understand that there is no simple official macro giving me something like the last 1-3 versions (versionnumber + date of lates edit), optionally accompanied by comment and contributorname.

    Dear Atlassian Support - have you ever held a 3-4ish week old PDF-Export (full with your own remarks) in your hands and wondered which version of the confluence page this PDF reflected?

    Without this addition this macro is not suitable for the job. I cannot add the whole version history (hundreds of entries long => screen:usablity nightmare, print: tree's nightmare).

  19. Oops. Not logged in. Comment above was me.

  20. Anonymous

    Still no reply since....2011. Atlassian Support what's wrong with you guys???

  21. Anonymous

    In the change history you can see the exact date AND time of the change.

    But under the page title (where the name of the author and the last editor are displayed) there you can only see the date of the last change, not the time.

    For example in comments it is possible to put the mouse cursor on the date and then the time appears. But this feature is not available for the date under the page title. Would be really nice not having to go to the change history only for seeing the time of a change.


  22. We'd also like to be able to limit the number of items returned by the macro.

    I've created a new feature request here - CONF-32315 - Allow users to limit the number of items the change-history macro returns New

    Please feel free to add your votes to that if you also want this functionality.  

  23. Have added my vote.

  24. December 2014, still no response

    1. Hi Kieren,

      Unfortunately this has to compete with all of the other priorities in Confluence development. Huw Evans has done the right thing in raising an issue, but I can't say if/when it'll be actioned.

      I'd suggest watching the issue to see when there's any activity on it.

      CONF-32315 - Allow users to limit the number of items the change-history macro returns New

  25. Is it possible to edit a comment added using the Change-History macro?

    1. Hi Namrata,

      Unfortunately, no, there's no way to edit a change comment. There's an open improvement suggestion, which you can comment on, and watch to get any updates.

      CONF-30810 - Ability to Require, Add, and Edit Revision Comments New

  26. Hi,

    I'm running Confluence 5.3.  I don't see anything in the edit mode to add comments.  How do you add comment to the Change-History Macro?

    1. Hi Michael,

      When you edit a page, you can add your change comment to the field at the foot of the page that says, 'What did you change?'.

      The change history macro just grabs those change comments and displays them.

      1. Thanks, Giles!  That's exactly what I wanted to know.