Supported Confluence formatting and macros

Owned by Johannes Laatu (Deactivated)
Last updated: Nov 19, 2024 by Madzy Soetman
3 min read

Refined sites offer support for pages published with the new Confluence editor. Pages in the legacy editor may not work as expected. Not sure which editor you use? Read Atlassian’s documentation.

Refined adjusts the look of Confluence pages to make them blend in with your Refined site. In the table below, you can see which formatting and macros are supported.

Although the vast majority of Confluence pages are displayed without problem, you might want to add pages to your sites that include formatting or macros that aren’t supported. To show pages exactly as they look in Confluence, enable the embedded pages feature.

For information about macros and formatting from other third party Atlassian Marketplace apps, see the integrations and supported apps page.

Formatting

Feature

Support

Comment

Feature

Support

Comment

Text

SupPorted

 

Headings

SupPorted

 

Paragraph

SupPorted

 

Bullet list

SupPorted

 

Italic

SupPorted

 

Bold

SupPorted

 

Underline

SupPorted

 

Strikethrough

SupPorted

 

Superscript

SupPorted

 

Code

SupPorted

 

Link

SupPorted

 

Indentation

SupPorted

 

Alignment

SupPorted

 

Text size

SupPorted

 

Text color

SupPorted

 

Highlight color

coming soon

 

Ordered list

SupPorted

 

Media

SUPPORTED

 

Info panel

SupPorted

 

Layouts

SupPorted

 

Tables

SupPorted

 

Emojis

SupPorted

 

Custom emojis

partial

 

Hard break

SupPorted

 

Mention

SupPorted

 

Code block

SupPorted

Code highlight support:

  • Java

  • JavaScript

  • SQL

  • PHP

  • Python

  • C#

  • C++

  • Ruby

  • XML

  • JSON

  • CSS

  • HTML

  • Go

  • YAML

Note that all other languages will still be displayed.

Status

SupPorted

 

Date

SupPorted

 

Expand

SupPorted

 

Rule

SupPorted

 

Task list

SupPorted

 

Decision list

SupPorted

 

Attachments

SUPPORTED

Thumbnail and inline.

Inline comments

Unsupported

 

Breakout

Ignored

Refined sites don’t support break out of images and tables, since all pages have the same width on a Refined site.

Placeholder

Ignored

Refined sites don’t show the placeholder module, since it doesn't add any value on a site. 

Smart links

Partial

  • Inline view: links to Atlassian content

  • Card view: links to Atlassian content

  • Embed view: Figma, Canva, Youtube, Spotify, Vimeo and Google Drive (not editing)

When your smart link isn’t supported, we recommend adding the link to text instead. This always works on Refined sites.

Macros

Macro

Support

Comment

Macro

Support

Comment

Gallery

SupPorted

 

Include

SupPorted

 

Excerpt

SupPorted

 

Excerpt - include

SupPorted

The excerpts show only with borders.

Pagetree

Partial

Supported settings:

  • Root page

  • Restrict to this Space Key 

Content by label

Partial

Supported settings:

  • Sort by (including reverse sort)

  • Maximum Number of Pages

  • Title

Labels and space names don't show for each listed page. We currently don't support the rich content and simple display mode of excerpts.

Content Report Table

Partial

Supported fields:

  • Labels

  • Space

  • Number of pages

Table of Content

Partial

“Basic” settings: full support.

“Advanced” settings: support for CSS class name

Jira Legacy (formerly Jira Issue/Filter)

SupPorted

need to have Refined for JSM installed

Jira Issue

Unsupported

Use the Jira Legacy macro instead.

Jira Timeline

partial

Always shown as a link, regardless of whether you select URL, inline, card, or embed.

Jira Charts

Unsupported

 

Jira Issue calendar

Unsupported

 

Jira Roadmap

Unsupported

 

Advanced Roadmaps for Jira

Unsupported

 

Jira Labels Gadget

Unsupported

 

Details

SupPorted



Profile picture

SupPorted



Widget

SupPorted



Attachments

Partial

Refined sites support viewing and downloading the latest version of an attachment. Sorting on:

  • Labels

  • Size

  • Pageid

  • SortBy and sortOrder

Children

Partial

Supported settings:

  • Parent Page

  • Depth of Descendants

Note that only pages are displayed from the space that the macro is on, and not from other spaces.

Create from template

Ignored

Refined sites don’t show this macro, because page creation isn't possible on-site. 

Blog Post

Partial

Supported settings:

  • Content type to display

  • Spaces

  • Labels

  • Maximum Number of Blog Posts

  • Sort on title, last modified, creation. Reverse order on sort type.

Spaces List

Partial

Supported settings:

  • Scope of spaces - all, new and favorite. For category all will be shown.

User Profile

Partial

Doesn’t display email and user role.

Labels List

SupPorted



Inline and block links

SupPorted

Inline and block links to:

Embed (iFrame)

SupPorted

Supported links: Youtube, Spotify, Vimeo, Google Docs, Google Drive, Canva, and Figma.

Iframe

SupPorted

Supported: height, width, align, frameborder, scrolling

Task Report

Partial

Supported:

  • Filtering tasks on space(s) and page(s), assigned to, created by, created after, and task status.

  • Columns to display

Not supported:

  • Filtering by labels and number of tasks per page

  • Sorting

Live Search

Partial

Supported settings:

  • Space

  • Filter by type (partial support: page, blog post)

  • Filter by label

User list

SupPorted

 

Recent updates

SupPorted

 

Anchor

SupPorted

Instead of linking to #anchor-name, add /#anchor-name after the URL of the page on the Refined site. For example: intranet.example.com/space/ACC/58720372/account#anchor-name.

Change history

SupPorted

 

Cards

SupPorted

 

Carousel

SupPorted