/
Supported Confluence formatting and macros

Supported Confluence formatting and macros

Owned by Johannes Laatu (Deactivated)
Last updated: Jan 28, 2025 by Madzy Soetman
3 min read
[ 1 Formatting ] [ 2 Macros ]

Refined sites support 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.

Your sites also support a range of macros and formatting from third-party Atlassian Marketplace apps.

Formatting

Feature

Support

Comment

Feature

Support

Comment

Text

status:SupPorted

 

Headings

status:SupPorted

 

Paragraph

status:SupPorted

 

Bullet list

status:SupPorted

 

Italic

status:SupPorted

 

Bold

status:SupPorted

 

Underline

status:SupPorted

 

Strikethrough

status:SupPorted

 

Superscript

status:SupPorted

 

Code

status:SupPorted

 

Link

status:SupPorted

 

Indentation

status:SupPorted

 

Alignment

status:SupPorted

 

Text size

status:SupPorted

 

Text color

status:SupPorted

 

Highlight color

status:SupPorted

 

Ordered list

status:SupPorted

 

Media

status:SUPPORTED

 

Info panel

status:SupPorted

 

Layouts

status:SupPorted

 

Tables

status:SupPorted

 

Emojis

status:SupPorted

 

Custom emojis

status:SupPorted

 

Hard break

status:SupPorted

 

Mention

status:SupPorted

 

Code block

status: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

status:SupPorted

 

Date

status:SupPorted

 

Expand

status:SupPorted

 

Rule

status:SupPorted

 

Task list

status:SupPorted

 

Decision list

status:SupPorted

 

Attachments

status:SUPPORTED

Thumbnail and inline.

Inline comments

status:Unsupported

 

Breakout

status:Ignored

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

Placeholder

status:Ignored

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

Smart links

status: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

status:SupPorted

 

Include

status:SupPorted

 

Excerpt

status:SupPorted

 

Excerpt - include

status:SupPorted

The excerpts show only with borders.

Pagetree

status:Partial

Supported settings:

  • Root page

  • Restrict to this Space Key 

Content by label

status: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

status:Partial

Supported fields:

  • Labels

  • Space

  • Number of pages

Table of Content

status:Partial

“Basic” settings: full support.

“Advanced” settings: support for CSS class name

Jira Legacy (formerly Jira Issue/Filter)

status:SupPorted

need to have Refined for JSM installed

Jira Issue

status:Unsupported

Use the Jira Legacy macro instead.

Jira Timeline

status:partial

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

Jira Charts

status:Unsupported

 

Jira Issue calendar

status:Unsupported

 

Jira Roadmap

status:Unsupported

 

Advanced Roadmaps for Jira

status:Unsupported

 

Jira Labels Gadget

status:Unsupported

 

Details

status:SupPorted



Profile picture

status:SupPorted



Widget

status:SupPorted



Attachments

status:Partial

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

  • Labels

  • Size

  • Pageid

  • SortBy and sortOrder

Children

status: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

status:Ignored

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

Blog Post

status: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

status:Partial

Supported settings:

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

User Profile

status:Partial

Doesn’t display email and user role.

Labels List

status:SupPorted



Inline and block links

status:SupPorted

Inline and block links to:

Embed (iFrame)

status:SupPorted

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

Iframe

status:SupPorted

Supported: height, width, align, frameborder, scrolling

Task Report

status: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

status:Partial

Supported settings:

  • Space

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

  • Filter by label

User list

status:SupPorted

 

Recent updates

status:SupPorted

 

Anchor

status: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

status:SupPorted

 

Cards

status:SupPorted

 

Carousel

status:SupPorted

 

PDF

status:Partial

PDF macro renders as a thumbnail in Refined, whereas in Confluence it embeds the PDF content to page.

 

Related content