Pages module

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

The Pages module shows an overview of pages that belong to one or more Confluence spaces. It can include images, titles, dates, and authors. If a page has one or more images, the module shows the first image on the page.

Add this module to a page

Go to a landing page on your site.
Click the Edit page button.
Hover your mouse over the desired location on the page and click the + Add module button that appears.
Click Pages in the left-hand menu.
Select the Pages module.

Edit the title

Simply click the module’s title to start writing and formatting. You can use text variables to make the text dynamic, for example to display the user’s first name.

Edit the settings

Click the module to open its settings menu, which appears on its right-hand side.
Edit the settings, which are divided over multiple tabs:

Module tab

Setting

Description

Background

Add an Image, Color, or Gradient as background – or turn off the background by selecting None.

There are multiple ways to pick a color:

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 color from anywhere on the page (available in the browsers Firefox and Edge).
Click one of the recently used colors.

Use the vertical slider in the middle of the popup to control the color’s opacity.

Fixed height

By default, all modules adjust their size to their content. To set a fixed height instead, fill in the desired height in pixels.

Pages tab

Setting	Description
Display style	Card view shows titles, publication dates and images for each page. Simple list shows only page titles.
Avatars	Show or hide the page authors' avatars (profile pictures). Users set up their avatars in their Atlassian account.
Number of items	Enter the amount of pages you want to display by default. Users can click a button to load more pages.
Filter	Filters let you narrow down which pages from your site's Confluence spaces to show. Simple lets you use filter by label and space. Select Advanced to filter with CQL.
Filter by label Available when Filter is set to Basic.	Enter a label you use in Confluence to only include pages with that label. Add a dash ( - ) in front of a label to exclude pages. Separate multiple labels with commas.
Filter by space Available when Filter is set to Basic.	To show pages from all Confluence spaces on your site, leave this field empty. To show pages from one or more other spaces, add space keys separated with commas. Exclude a space key by adding a dash ( - ) in front of it. To show dynamic content, enter a text variable: Is the module placed on a Refined page? Enter $spacekeys to show pages from all spaces that are grouped under the Refined Page in the site structure. Is the module placed on a Confluence space landing page? Enter $spacekey to show pages from only the landing page’s Confluence space.
Order by Available when Filter is set to Basic.	Arrange the content by modification date, creation date, or alphabet.
Filter with CQL Available when Filter is set to Advanced.	Use "type = page". Make the filter dynamic with text variables. For example, show the user's favorite pages: favorite = currentUser() and type = page

Images

By default, the module shows an image from the blog post (if available). You can also set a custom preview image (and text) instead. Images are shown in a 4:3 landscape (horizontal) format. We recommend using images that are at least 800x600 pixels.