Page Info Macro

The Page Info macro makes it easy to display information about the page it is used on. This could include information such as page versions, differences in versions, contributors and many other options listed below.

Usage

  1. Click Insert > Other Macros.

  2. Select the Page Info macro from the provided list.

  3. Complete the desired fields:

    ParameterDescriptionTypeDefaultRequired

    Information Type

    See the supported Information Types table below.

    enum

    Commenters

    Yes

    Page

    The name of the page whose information you want displayed. If no name is given, then the current page is assumed.

    Options $self and $parent can be used to refer to the current page and the parent page respectively.

    string

    $self

    No

    Date Format

    Set the display format for the date and time displayed. When no date is to be displayed this parameter has no effect.

    This uses Confluence’s DateFormatter API, which in turn uses a java.text.SimpleDateFormatter. See the Oracle documentation on how to create your own custom date format string.

    string

    MMM dd, yyyy - hh:mm

    No

    Type a

    Show list information in different formats.

    Options are Flat to display a comma separated list or List to display a bullet list.

    enum

    Flat

    Yes

    Prefix

    Inserts a prefix before the version number. This field has no effect on display types without a version number.

    string

    None

    No

    Reverse Order

    Reverse the list item when the option is selected.

    Checkbox

    Unchecked

    No

    Count

    Limit the number of items shown in a list (eg. versions and diffs).

    int

    None

    No

    Show Comments

    Display the comments that accompany an update.

    If you select this option, the comments refer to the page version comments (entered in the What Did You Change? field) which can be added before saving the page.

    Checkbox

    Unchecked

    No

    Show Versions

    Display the version numbers.

    Checkbox

    Checked

    No

    Supported values for the Information Type field follow:

    Information TypeDescription

    Created By

    The user who created the page.

    Commenters

    A comma-separated list of the users who have commented on the page.

    Create Date

    The date the page was created.

    Current Version

    The most recent version number of the page.

    Diffs

    A comma-separated list of version number links. These are clickable to view the differences between versions.

    Labels

    A comma-separated list of labels. These are clickable to view other pages that possess the same label.

    Modified By

    The user who last modified the page.

    Modified Date

    The date the page was last modified.

    Modified Users

    A comma-separated list of all the users who have modified the page.

    Page ID

    The ID of the current page.

    Participants

    A comma-separated list of the users who have modified or commented on the page.

    Title

    The title of the page.

    Tiny URL

    A tiny url link to the specified page.

    Versions

    A comma separated list of version numbers. These are clickable to view the selected version.

    The following image is an example of a selected field:

The following image shows the output when Created By is selected for the Information Type field. In this example, the page was created by the admin.

Example

The following two images show how the Page Info macro can be used to populate information.

The input:

The output:

Tips for the Page Info Macro

  • Formatting Dates: The Page Info macro supports standard date formats which allows the user to format the date with various combinations. For example the following screenshot shows how to use "dd-MMM-yyyy" as the date format.

    Examples of formatted dates follow:

    Page Edit ModePage Output

  • Displaying Versions and Diffs: The versions and differences ("Diffs") are clickable to view a particular version and difference.

  • View Page Information for a Different Page: Provide the name of the page for which information will be displayed. The following example shows the page creator for page P2. It is also possible to use "$parent" [without double quote] to refer to the parent page of the page that contains the macro.

On this page