The Recently Updated macro displays a list of the most recently changed content within Confluence.

(info) The Recently Updated Dashboard macro is similar to this macro, but is intended for display on the Confluence dashboard.

On this page:

Usage with the Macro Browser

To insert the recently updated macro into a page using the Macro Browser,

  1. Open your desired Confluence page or blog post, then click the 'Edit' button. The page or blog post opens in edit mode.
  2. Click the Macro Browser icon on the toolbar. The macro browser window opens in the middle of the screen in 'macro selection' mode.
  3. Scroll through the list of macros. Alternatively, start typing part of the name of your desired macro into the search box at the top right of the macro browser window. Macros with a matching name will appear in the main pane.
  4. Click on the desired macro to access its parameters and preview parameter changes ('preview mode').
  5. Set the macro parameters to your requirements. If desired, you can preview these changes by clicking 'Refresh'.
  6. Click 'Insert' to put the macro into the page.

Once you've found the recently updated macro and have added the required parameter values, click 'insert' to add it to your page.

Usage with the Wiki Markup Editor

{recently-updated}

Working Example of Usage

Below is a working example of the 'Recently Updated' macro which by default, lists 15 results.

必要な入力項目

表示結果

{recently-updated}

最近更新された課題

Show More

パラメーター

Parameters are options that you can include in Confluence macros to control the content or format of the macro output. The table below lists relevant parameters for this macro.

Parameter names are different in the macro browser and in wiki markup. Below we show the macro browser parameter names in bold text, and the equivalent wiki markup parameters in (bracketed) text. If we do not show any parameter name for the wiki markup, then you should leave out the parameter name and simply include the parameter value as the first parameter, immediately after the colon (:).

パラメーター

必須かどうか

既定

説明

Author(s) by username
(author)

いいえ

指定なし (すべてのコンテンツを表示)

Filter the results by author. The macro will display only the pages etc which were last modified by the author(s) you specify here.

You can specify one or more authors, separated by a comma or a space.

Label(s)
(label) or (labels)

いいえ

指定なし (すべてのコンテンツを表示)

結果をラベルで絞り込みます。ここで指定したラベル (複数可) でタグ付けされているページ等のみがマクロで表示されます。

カンマまたはスペースで区切ることで、1 つ以上のラベル値を指定できます。

  • To exclude content which matches a given label, put a minus sign (-) immediately in front of that label value. For example: If you specify a label value of -badpage you will get only content which is not labelled with 'badpage'.
  • 特定のラベル値を持つ結果のみを指定するには、ラベル値のすぐ前にプラス記号 (+) を追加します。例: ラベル値を +superpage,+goodpage と指定すると、少なくとも "superpage" と "goodpage" の 2 つのラベルを持つコンテンツのみを取得できます。

(info) If there are no pages matching any of the specified labels, then Confluence will ignore the labels and will list all recently updated pages, as well as showing a message, "These labels don't exist and were ignored: xxx ". This unexpected behaviour is noted in issue CONF-10167.

Maximum Number of Results
(max) or (maxResults)

いいえ

15

Specify the maximum number of results to be displayed. If this parameter is omitted, then a maximum of 15 results are displayed. The theoretical maximum value that this parameter can accept is 2 to the power of 31, minus 1 (or 2147483647).

Show User Profile Pictures
(showProfilePic)

いいえ

false

コンテンツを更新したユーザーのプロファイル画像を表示するには showProfilePic=true を指定します。

Space(s)
(space) or (spaces)

いいえ

@self, i.e. the space which contains the page on which the macro is used

このパラメータを使用すれば、スペースでコンテンツを絞り込むことができます。ここで指定したスペース (複数可) に属するページ等のみがマクロで表示されます。

カンマまたはスペースで区切ることで、1 つ以上のスペース キーを指定できます。

  • 特定のスペースのコンテンツを除外するには、スペース キーのすぐ前にマイナス記号 (-) を追加します。例: スペース キーを -BADSPACE と指定すると、BADSPACE に含まれないコンテンツのみを取得できます。
  • 特定のスペースのコンテンツのみを指定するには、スペース キーのすぐ前にプラス記号 (+) を追加します。例: スペース キーを +GOODSPACE と指定すると、GOODSPACE のコンテンツのみを取得できます (各コンテンツ項目は 1 つのスペースにのみ所属するため、このオプションが有効な麺は少ないことにご注意ください。1 つのスペース キーの前にプラス記号を設定してほかのスペース キーを一覧に追加した場合、追加したスペース キーは無視されます)。

特別な値:

  • @self — 現在のスペース。
  • @personal — All personal spaces.
  • @global — All global spaces.
  • @favorite — The spaces you have marked as favourite.
  • @favourite — 上記の @favorite と同様。
  • @all — Confluence サイトのすべてのスペース。
  • * — 上記の @all と同様。

(info) When specifying a personal space, remember to use the tilde (~) sign in front of the username, such as ~jbloggs or ~jbloggs@example.com.

Include these Content Types Only
(type) or (types)

いいえ

すべてのタイプ

このパラメータを使用すれば、コンテンツ タイプでコンテンツを絞り込むことができます。ここで指定したコンテンツ タイプのみがマクロで表示されます。

カンマまたはスペース区切りで複数のタイプを指定できます。

特定のコンテンツ タイプのコンテンツを除外するには、そのコンテンツ タイプのすぐ前にマイナス記号 (-) を追加します。例: コンテンツ タイプを -blogpost と指定すると、ページと、ブログ投稿を除くその他すべてのコンテンツを取得できます。

利用可能な値:

Width of Table
(width)

いいえ

100%

マウロの表示幅を、ウィンドウ幅に対するパーセント値で指定します。

theme
(theme)

いいえ

'concise' with the heading 'Recently Updated'

このマクロの外観を選択します。

  • concise — 更新またはコメントされたページ名、ページ通知をトリガーしたユーザー、変更日時を表示する既定のリスト。
  • social — 最近の変更を新しい順に一覧表示しますが、ユーザーごとに短期間のセグメントでグループ化します。各ユーザーの時間セグメントには "サブ" リストが表示され、更新またはコメントされたページの名前と、これらの変更が行われた日時を示します。
  • sidebar — 最近の更新を新しい順にリストし、更新またはコメントされたページの名前と、ページの変更日時を示します。このテーマでは作者を表示しません。

例

1. Include content from all spaces

The code below will show all the pages from all the spaces that have been recently updated:

{recently-updated:space=@all}

2. Include content from specific spaces

Use the code below to specify the spaces for which you want to view recently updated content:

{recently-updated:space=SPACEKEY1,SPACEKEY2}

3. Specify the width of the display

Use the code below to limit the width of the display to 50% of the window:

{recently-updated:width=50%}

4. Filter content using labels

The code below will include recently updated content labelled with 'timesheets' or 'summaries', from the 'sales' and 'marketing' spaces, provided that the content is not labelled with 'obsolete':

{recently-updated:space=sales,marketing|label=timesheets,summaries,-obsolete}

5. Filter by content type

Use the code below to show pages only (not news items, comments or any other content type):

{recently-updated:type=page}

6. Change the number of results in the list

The code below changes the number of results listed (from the default value of 15) to 8:

{recently-updated:maxResults=8}

7. Display profile pictures

The code below will display the profile picture of the user who most recently updated the content.

{recently-updated-dashboard:showProfilePic=true}

8. Display recent comments, including profile pictures and text

The code below will display recent comments in the current space, showing the profile picture of the users who made the comments, plus the first line or two of the comment text.
(info) This is the only way to ensure that the text of the comments is displayed, using this macro.

{recently-updated-dashboard:types=comment|showProfilePic=true}

Customising the wording

If you would like to change the wording displayed by the 'Recently Updated' macro, please refer to the document on modifying the Confluence interface text.

関連トピック

Recently Updated Dashboard Macro
Viewing Recently Updated Content
Working with Macros

Take me back to the Confluence User's Guide.

  • ラベルなし

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.