View Source

The Blog Posts Macro allows you to display blog posts on a wiki page. Clicking on a title takes you to the blog post. The blog posts macro will generate output like the screenshot below:

Screenshot: The Blog Posts Macro in Confluence

Confluence 3.3 > Space Attachments Directory > Confluence_3.0_Blog_Posts_Macro_Screenshot.png

On this page:

Usage with the Macro Browser

To insert the blog posts macro into a page using the Macro Browser,

Once you've found the blog posts macro, click 'insert' to add it to your page.

Usage with the Wiki Markup Editor

Simply type the following into the Wiki Markup editor:

{blog-posts}

In the example below, we show the blog posts from a user's personal space on this Confluence site. (The person's username is ~mryall.)

What you need to type

What you will get

{blog-posts:space=~mryall}

Parameters

Parameter	Default	Description
(`author`)	None	Filter the results by author. The macro will display only the blog posts which are written by the author(s) you specify here. You can specify one or more authors, separated by a comma.
Content Type to Display (`content`)	entire	Available values: `content=excerpts` — Display short excerpts from each blog posts. After each excerpt, the words 'Read more...' will offer a link allowing the user to click through to the full blog post, if the content is over 500 characters long. `content=titles` — Display a list of blog posts, showing titles only.
Restrict to these Labels (`label`)	None	Filter the results by label. The macro will display only the blog posts which are tagged with the label(s) you specify here. You can specify one or more label values, separated by a comma or a space.
Restrict to these Labels (`labels`)	None	Exactly the same as `label` above.
Maximum Number of Blog Posts (`max`)	15	Specify the maximum number of results to be displayed. Note that the results are sorted first, and then the maximum parameter is applied.
Maximum Number of Blog Posts (`maxResults`)	15	Exactly the same as `max` above.
Reverse Sort (`reverse`)	false	Use this parameter in conjunction with the `sort` parameter described below. Set `reverse=true` to change the sort from ascending to descending order. this parameter is ignored if the `sort` parameter is not specified.
Sort By (`sort`)	creation	Specify how the results should be sorted. To change the sort order from ascending to descending, use the `reverse` parameter described above. If this parameter is not specified, the sort order defaults to descending order based on the creation (publish) date. Values:
Restrict to these spaces (`space`)	@self, i.e. the space which contains the page on which the macro is coded	This parameter allows you to filter content by space. The macro will display only the pages which belong to the space(s) you specify here. You can specify one or more space keys, separated by a comma or a space. Special values:
Restrict to these spaces (`spaces`)		Exactly the same as `space` above.
Time Frame (`time`)	no limit	Specify how far back in time Confluence should look for the blog posts to be displayed. Available values: `m` — Minutes `h` — Hours `d` — Days `w` — Weeks For example, `time=12h` would display those blog posts created in the last twelve hours, and `time=7d` would show blog posts created in the last seven days.

Examples

1. Specify the number of blog posts you want displayed

The following code will display a maximum of five blog posts:

{blog-posts:max=5}

2. Display short excerpts from each blog post in the list

{blog-posts:content=excerpts}

3. Display only the titles of the blog post

{blog-posts:content=titles}

4. Choose how far back in time Confluence should look for the blog posts

The following code will display all blog posts posted in the last twelve hours.

{blog-posts:time=12h}

The following code will display all blog posts posted in the last 2 weeks.

{blog-posts:time=2w}

5. Filter items using labels

The following code will display blog posts that contain the labels 'atlassian' or the label 'confluence' (or both):

{blog-posts:labels=atlassian,confluence}

The following code will display blog posts that contain the labels 'atlassian' and 'confluence' — each blog post must be tagged with both labels:

{blog-posts:labels=+atlassian,+confluence}

6. Filter items using spaces

The following code will display items from the 'Marketing' space (space key is MKTG) and Joe Smith's personal space (space key is ~jsmith):

{blog-posts:spaces=MKTG,~jsmith}

7. Combine parameters to filter the blog posts

The following code will display the latest 10 items in the 'Marketing' space (space key is MKT) with the label 'logo'. The items will be displayed as a list of titles only:

{blog-posts:max=10|labels=logo|spaces=MKT|content=titles}

8. Sort the results

Use the code below to sort the list of items by date last modified, with the most recent at the top:

{blog-posts:sort=modified|reverse=true}