News macro

The News macro highlights blogs from a space.

Add and edit the macro

You can add macros to pages, user dashboards, and space layouts.

To change its settings, click the macro > Edit.

Parameter

Description

Available since version

Parameter

Description

Available since version

Title

The macro’s title.

 

Type

  • News displays blog posts marked as Visible on dashboard. You can easily control which blog posts are included, by using the News System.

  • Blog displays blog post from blogs.

  • Blog-portal displays blog post from blogs located in the Blog Portal.

  • Regular displays all news and blog posts, similarly to the Atlassian blog post macro.

1.3

Theme

  • Default shows compact items that expand to show excerpts when clicked.

  • Simple shows excerpts directly: no need to expand them.

4.0

Max items

The maximum number of items to be displayed.

1.2.4

Profile picture

Show profile pictures of news item creators.

1.2.4

Categories

Filter content by categories. Specify one or more category keys, separated by a comma.

3.3

Spaces

Filter content by spaces. Specify one or more space keys, separated by a comma or a space. To use the current space, specify @self.

1.0

Labels

Filter content by labels.

  • Specify one or more labels, separated by a comma or a space.

  • Exclude content label by putting a minus sign (-) in front of that label (for example: -excludelabel).

  • Indicate that the results must match a given label, put a plus sign (+) in front of that label (for example, +includelabel).

1.3

Show space name

Select to show the name of the space in which the blog post is located.

3.1

View in popup

Select to let users view blog posts in a popup.

Introduced in 3.1, removed in version 6.0.

 

Expand first item

Select to automatically open the first news item.

Introduced in 3.3, removed in version 6.0.

 

Macro key

Macro keys are used to identify macros in the macro browser and to build custom solutions. The News macro key is rw-news.