Displaying pages and blog posts as in native Confluence

Displaying pages and blog posts as in native Confluence

By default, Refined sites render Confluence pages and blog posts with a distinct look, which supports many but not all Confluence styling options and macros. If your pages and blogs contain unsupported formatting or macros, you can display them exactly as they look in native Confluence:

  • Display any third-party macro

Here’s a Swagger macro from Just Add+ by Modus Create, shown using the “display as in native Confluence” option on a Refined site

justaddexample-moduscreate.png
Example third party macro render
  • Show all original formatting

  • Edit directly on the Refined site. This is only possible for the new Confluence editor and if you have Confluence permissions to do so.

Due to technical limitations, this feature is only available on private sites that don’t have a custom domain. You need to have third-party cookies enabled. Please vote on this public Atlassian ticket.

image-20240327-163449.png

Display pages as in native Confluence

  1. Go to Confluence space settings.

  2. Turn on Display pages as in native Confluence.

Impact on other settings and performance

Displaying pages as in native Confluence:

  • Disables the following the space settings:

    • Display authors. The pages will still show author and last updated though, because this is standard information on a native Confluence page.

    • Show estimated read time

    • Table of content

  • Moves some controls that are normally located at the top of the page, to the bottom of the page:

  • May cause slightly slower performance on-page.

  • May cause certain page interactions not to work, such as opening links located within third-party macros.

Additionally, since pages are shown in an iFrame, some macros will be displayed as an iFrame within an iFrame (e.g. Miro or Figma). In those cases, this may result in a sub-optimal experience for users. For example, the Table of Contents macro renders but can’t be clicked to go to the relevant location on the page.