Search the Confluence 4.1.x Documentation:

Index
Downloads (PDF, HTML & XML formats)
Other versions

This documentation relates to Confluence 4.1.x
If you are using an earlier version, please view the previous versions of the Confluence documentation and select the relevant version.
Skip to end of metadata
Comment: Corrected links that should have been relative instead of absolute.
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 this information inline, as shown in the following screenshot.

Screenshot: The Change-History Macro in Confluence

On this page:

Using the Change-History Macro

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.

Notes

There are no parameters for this macro.

Related Topics

Working with Macros

Take me back to the Confluence User's Guide.

Labels:
None
Edit Labels

13 Comments

Hide/Show Comments

  1. Mar 02, 2011

    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,

    Sascha

  2. Mar 23, 2011

    Anonymous

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

  3. Apr 01, 2011

    Anonymous

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

  4. May 15, 2011

    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. Jun 29, 2011

    Anonymous

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

  6. Jul 08, 2011

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

  7. Jul 15, 2011

    Anonymous

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

  8. Sep 05, 2011

    Anonymous

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

  9. Sep 08, 2011

    Andrew Townsend

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

  10. Oct 25, 2011

    Anonymous

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

  11. Nov 04, 2011

    Anonymous

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

    Joachim, Sensor Developments 

  12. Nov 28, 2011

    Anonymous

    Hey guys,

    Try this:

    https://www.adaptavist.com/display/AtlassianConfluence/version-history+macro

    With version-history:first=10 for example.

    Chris

  13. Dec 09, 2011

    Anonymous

    Just replace {change-history} with comment

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