News module

This module is only available if you have installed Refined for Confluence Cloud.

The News module displays blog posts from a Confluence space as thumbnails in chronological order. For example, you can use this module on a help desk site to show a product’s latest features, as we have done on help.refined.com’s Refined for Cloud landing page.

Add this module to a page layout

All Refined Pages, Jira Projects, and Confluence Spaces that you add in the Site Builder get their own landing page on your Refined site. Modules are the building blocks of these pages.

Go to a page’s Layout Editor.
Hover your mouse over a spot in the layout and click the + Add module button that appears.

Edit the title

Simply click the module’s title to start writing and formatting. Use text variables such as $userfirstname to make this title dynamic.

Formatting option	Description
Text styles	Choose the paragraph style or one of the five heading styles.
Text sizes	Available sizes range from 10 - 72 pixels.
Font	All modules use the font that you set in the theme.
Colour	There are multiple ways to select a colour: Select the shade and hue at the top of the popup. Enter an rgb, rgba, or hex code. Click the eyedropper icon to select a colour from anywhere in the layout. Pick one of the recently used colours. Use the vertical slider located in the middle of the popup to control the colour’s opacity.
Emphasis	Make the text bold, italicised, or underlined.
Alignment	Align the text to the left, centre, or right.
Lists	Create a numbered list or bullet list.
URL	Add a link to the text.
Remove formatting	Change the text back to its default look.

Edit the settings

Select the module to see its menu, which appears on its right-hand side.
Click the Cogwheel.

Module tab

Setting	Description
Fixed height	By default, all modules adjust their size to their content. If you want a fixed height instead, fill in the desired height in pixels.

News tab

Setting	Description
Display style	Image feed shows the blogposts' image, title and publishing date. Content feed shows the blogposts' image, title, description and publishing date. List shows the blogposts' publishing date and title. Slideshow shows the blogposts one by one. It includes the blogposts' image, title and publishing date.
Avatars	Show or hide the blog authors' avatars (profile pictures). Users set up their avatars in their Atlassian account.
Number of items	Enter the amount of blogposts you want to show by default. Users can always click a button to load more, except when the Display style is set to Slideshow.
Filter	Filters let you narrow down which blog posts from your site's Confluence spaces to show. Simple lets you filter by label, space and author. Select Advanced to filter with CQL.
Filter by label Available when Filter is set to Basic.	Enter a label to include only the blog posts that have that label in Confluence. Add a dash ( - ) in front of a label to exclude its blog posts. Separate multiple labels with commas.
Filter by space Available when Filter is set to Basic.	Decide which spaces to include: Leave this field empty to show blog posts from all Confluence spaces on your site. When placed on a page that is created from a Confluence space, use the text variable $spacekey to show blog posts from only that space. To show blog posts from one or more other spaces, add space keys separated with commas. Exclude a space key by adding a dash ( - ) in front of it.
Filter by author Available when Filter is set to Basic.	Enter a creator's Account ID to include their blog posts. Add a dash ( - ) in front of an ID to exclude their blog posts. Separate multiple IDs with commas. To show only blog posts from the user viewing the page, use CQL (Advanced filter) with the function currentUser().
Filter with CQL Available when Filter is set to Advanced.	Use CQL to show specific blogposts. Use "type = blogpost". Make the filter dynamic with text variables. For example, show blog posts that the user added: type = blogpost AND creator = $username ORDER BY created DESC

Images

If the display mode includes images, they are displayed in 4:3 portrait (vertical) format.

The module automatically shows the first image located in each blogpost. If that image has a different ratio than 4:3, the module will crop it. We recommend using images that are at least 800x600 pixels.

If you want to use a different image, add metadata to the blogpost.

Description

If the display mode includes a description, the module automatically shows the blogpost’s first 250 characters. If you want to set a custom description, add metadata to the blogpost.