Page Builder

The Refined Page Builder.

Use the Page Builder to edit the content and looks of:

On this page

Access the Page Builder

There are two ways to access the Page Builder:

  1. Go to the page that you want to edit on your Refined site.

  2. Click the Edit page button in the top-right of the page.
    Or use the keyboard shortcut E for quick access.

  3. The next step depends on whether you used the Layout Editor for this page before: see the table below.

Or:

  1. Go to the Site Builder.

  2. Locate the page that you want to edit.

  3. Click its … (Three dots) > Edit Page.

Editing pages you’ve built with the Layout Editor

Pages built in the Layout Editor will be largely unaffected when they’re opened in the Page Builder. You may see a change on pages that contain:

  • Custom CSS

  • HTML modules

  • Cards modules

For a list of known design elements that may be impacted, click here.

Ensure your pages keep working and looking as intended, by already opening and publishing them with the Page Builder. This is especially important if you use custom CSS or HTML. You can still go back to the Layout Editor if you experience issues, which won’t be possible anymore after May 31.

Of course, our team is happy to help if you need any assistance: contact support

If you don't move page layouts to the Page Builder before May 31, layouts created and published from the Layout Editor will still be rendered to the end user unchanged, but you will only be able to edit them in the Page Builder, which could trigger the design changes mentioned above. 

Content and structure

Templates

Need a helping hand creating landing pages? Use one of the 30+ Confluence and JSM page templates that help you nail your page designs for intranets, documentation sites, knowledge bases, support desks, and more.

Modules are your page’s building blocks. Use them to:

  • Simplify site navigation. For example, highlight pages and blogs from Confluence spaces or direct users to other links with buttons, icons, and more.

  • Create user-friendly support portals, by showing requests and request types from JSM projects and highlighting Confluence knowledge base articles.

  • Add any other text, images, and other design elements you’d like.

Structure a page by clustering modules:

  • The largest possible group is called a section. It can have its own settings, including backgrounds.

  • Sections can be further organized into rows. Rows can also have their own settings and backgrounds.

  • Rows can can contain up to six columns that contain modules.

You can easily switch up your design by dragging and dropping modules, sections, and rows around.

Add a module

To add a module, simply hover your mouse over the desired location and click the + Add module button that appears. The availability of modules depends on which Refined app(s) you use.

Edit a module

Click a module to edit its settings: read a module’s documentation to learn about the possibilities (see the module overview above). Click the Two pages to duplicate the module. Click the Bin to delete the module.

Edit text in a module

Simply click a module’s text to start writing and formatting.

Formatting option

Description

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.

Color

There are multiple ways to select 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).

  • Pick one of the recently used colors.

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

Emphasis

Make the text bold, italicized, or underlined.

Alignment

Align the text to the left, center, 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.

Add a section or row

  1. Hover your mouse over an existing section.

  2. Click the + Section button or + Row button that appears below the section.

Use text variables

Use text variables to make the content of your modules dynamic. For example, you can use them in a heading or body text to personally welcome a user to your support site, or in a news module’s settings to show news from only certain spaces.

Edit a section

Click a section to make its menu appear at its top right-hand side:

  • Click the Lock to determine who can see the section.

  • Click the Cogwheel to edit the section’s settings: see the table below.

  • Click the Two pages to duplicate the section.

  • Click the Bin to delete the section.

  • Click the Arrows to move the section up or down the page. Alternatively, you can rearrange sections by dragging and dropping them.

Setting

Description

Setting

Description

Background

Choose which type of background to add.

  • Image

  • Color

  • Gradient

  • None

Spacing

Set the amount of space between sections. This setting also applies to the space between a section and the top or bottom of the page.

  • Tight

  • Default

  • Spacious

  • Custom - fill in a specific amount of pixels.

Edit a row

Click a section to edit it:

  • A menu appears at the row’s left-hand side:

    • Click the Lock to determine who can see the row.

    • Click the Cogwheel to edit the row’s settings: see the table below.

    • Click the Pages to duplicate the row.

    • Click the Bin to delete the row.

    • Click the Arrows to move the row up or down within the section. You can also drag and drop rows within or between sections.

  • A series of buttons at the top lets you decide on the amount of columns.

  • To change the width of a column, click and drag the column’s border.

Setting

Description

Setting

Description

Spacing

Set the amount of space between rows.

  • Tight

  • Default

  • Spacious

  • Custom - fill in a specific amount of pixels.

Height

Set the height of the modules within this row.

  • Fill - modules are stretched out to fit the row’s height.

  • Fit module - modules keep their default height.

Module alignment

Align modules to the top, middle or bottom of the row.

View Permissions

By showing different users and user groups only the sections and rows that are relevant to them, you can give them personalized experiences on-page.

  1. Hover your mouse over a section or row. You’ll see a menu appear on its top right-hand side (section) or left-hand side (row).

  2. Click the Lock.

 

Option

Description

Option

Description

Accessible to anyone

Any user can see the section or row. This is the default setting.

Logged-in users only

Only your organization's logged-in Atlassian users can view this section or row. It’s hidden for anonymous users. You can further restrict permissions to specific Atlassian user groups.

Anonymous users only

Only users who aren’t logged in can view this section or row. It’s hidden for your organization's logged-in Atlassian users.

Interactions with other permissions

You can also set general site access permissions and permissions on specific Refined Pages, links and menu folders.

All types of permissions are closely related and may impact each other. For example, a user who doesn’t have access to a landing page still won’t be able to see a section that’s set to be “accessible to anyone”.

Drafts and publishing

As you build your page, we automatically save drafts for you. The green check mark icon shows that the page you are working on is saved as a draft.

Click the Publish button to make the new version visible on your site, or click the downward arrow next to it for more options:

  • Publish with comment lets you add a comment to the published version. All comments are visible in the Version History in the left-hand menu.

  • Discard draft takes you back to the version that was last published.

Version history

To see an overview of previously published versions, go to the left-hand menu and click Version History. At the top of the list you find your current draft, if you have one. To restore, export, or delete a version/draft, hover your mouse over it and click the … (three dots) that appear.

Reuse page layouts

If you like the layout of a page and want to apply it on another page (and even another site) as well, simply export and import it.

Export a layout

To export the most recently published layout, open the left-hand menu and click Export/Import page layout. To export a draft, go to the Version History (see the paragraph above).

Import a layout

Open the left-hand menu and click Export/Import page layout.

Keyboard shortcuts

Use keyboard shortcuts to speed up the page-building process.

Action

Shortcut

Action

Shortcut

Publish

Ctrl/Cmd + S

Close

Shift + Esc

Undo

Ctrl/Cmd + Z

Redo

Shift + Ctrl/Cmd + Z

Return to the legacy Layout Editor

The legacy Layout Editor stays available only until May 30, 2024. Your users will see the most recently published version of the page, regardless of where it was made.

To go from the Page Builder to the legacy Layout Editor, open the left-hand menu and click Go to legacy Layout Editor.