Pages module (Page Builder)

Designed to replace the Layout Editor, our new what-you-see-is-what-you-get Page Builder lets you see your design come to life in real time as you build.

We’re releasing the Page Builder in phases.
Can’t wait to give it a go? Request access.

The Pages module shows a list of pages that belong to a Confluence space. It includes the page’s title, date, and author. If a page has one or more images, the module shows the first image on that page.

Add this module to a page

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

All Refined Pages, Confluence spaces, Jira projects and JSM portals 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 the Page Builder.
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.

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

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.

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 always 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 here to include only the pages that have that label in Confluence. Add a dash ( - ) in front of a label to exclude its issues. 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 pages 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 pages from only that space. To show pages from one or more other spaces, aadd space keys separated with commas. Exclude a space key by adding a dash ( - ) in front of it.
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 favourite pages: favorite = currentUser() and type = page

Images

When the Display style is set to Card view, the cards show the first image located on the page. Cards are displayed in 4:3 landscape (horizontal) 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.