Change-History Macro

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 Autocomplete for links, files, macros and mentions.

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

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

31 Archived comments

  1. User avatar


    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,


    02 Mar 2011
  2. User avatar


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

    23 Mar 2011
  3. User avatar


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

    01 Apr 2011
  4. User avatar


    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

    15 May 2011
  5. User avatar


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

    29 Jun 2011
  6. User avatar

    Yasushi Shiba

    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...

    08 Jul 2011
  7. User avatar


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

    15 Jul 2011
  8. User avatar


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

    05 Sep 2011
  9. User avatar

    Andrew Townsend

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

    09 Sep 2011
  10. User avatar


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

    25 Oct 2011
  11. User avatar


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

    Joachim, Sensor Developments 

    04 Nov 2011
  12. User avatar


    Hey guys,

    Try this:

    With version-history:first=10 for example.


    28 Nov 2011
  13. User avatar


    Just replace {change-history} with comment

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

    09 Dec 2011
  14. User avatar


    I also agree. This is a must have …

    13 Jun 2012
  15. User avatar


    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.


    19 Jul 2012
  16. User avatar


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

    27 Sep 2012
  17. User avatar


    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?

    03 Oct 2012
  18. User avatar


    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).

    05 Mar 2013
  19. User avatar


    Oops. Not logged in. Comment above was me.

    05 Mar 2013
  20. User avatar


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

    16 Apr 2013
  21. User avatar


    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.


    30 Sep 2013
  22. User avatar

    Huw Evans

    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.  

    21 Jan 2014
  23. User avatar

    Ian Trimnell

    Have added my vote.

    24 Jan 2014
  24. User avatar

    Kieran McKewen

    December 2014, still no response

    01 Dec 2014
    1. User avatar

      Giles Brunning [Atlassian Technical Writer]

      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

      01 Dec 2014
  25. User avatar


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

    03 Mar 2015
    1. User avatar

      Giles Brunning [Atlassian Technical Writer]

      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

      03 Mar 2015
  26. User avatar

    Michael Ling


    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?

    22 Apr 2015
    1. User avatar

      Giles Brunning [Atlassian Technical Writer]

      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.

      23 Apr 2015
      1. User avatar

        Michael Ling

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

        23 Apr 2015
  27. User avatar

    Maciej Ląd

    Atlassian Support any thing new in subject ? CONF-32315 - Allow users to limit the number of items the change-history macro returns New not chanfes very log time.

    This futures is very easy to programming, why don;t do it anything ?

    12 Aug 2015
Powered by Confluence and Scroll Viewport