Supported Macros and Features
The section will show you which macros and features of Confluence Cloud and K15t apps are supported by the Help Center theme and Scroll Viewport for Cloud.
Have a look at our Example Help Center to see how the supported macros look like on a live site.
SUPPORTED - macro or features is supported. If you have any issues with it, please raise a ticket.
PLANNED - the macro or feature is planned to be supported.
NOT SUPPORTED - this macro or feature is currently not supported and isn’t planned to be supported. If you need this macro or feature, please raise a ticket.
The following tables refers to macros and features of the new Confluence editor. We can’t guarantee support for macros that are exclusively available in Confluence’s legacy editor and recommend that you convert your pages to the new editor.
Confluence macros
Macro | Status | Comments |
---|---|---|
Panel macro | SUPPORTED | Custom panels are supported. Emojis in those panels will show as long as they are not custom emojis (see table). |
Anchor macro and anchor links | SUPPORTED | |
Attachments macro | SUPPORTED | The macro output in Viewport is a simple table that includes the file name, the file type and the modification date. The Viewport output excludes the upload area. |
Blog posts macro | NOT SUPPORTED | Since we currently don’t support blog posts, this macro isn’t supported. |
Change history macro | NOT SUPPORTED | |
Chart macro | NOT SUPPORTED | A bug in the app causes the image to break a few minutes after publishing. |
Child pages macro (formerly: Children display macro) | SUPPORTED | We override this macro to generate a consistent view of the content. If enabled via the macro’s configuration, Viewport will show:
|
Code snippet macro | SUPPORTED |
|
Filter by label macro (formerly Content by label macro) | SUPPORTED | The macro in Viewport will only show content of the type ‘pages’. Any pages that are not part of the current Scroll Viewport site or that lie outside the site’s content sources won’t show up in Viewport. The preview report will show a warning if you end up with completely empty macros on a page. |
Content report table | SUPPORTED | The link for ‘find more results’ will not work. We recommend to evaluate the ‘Filter by label’ macro as an alternative. |
Contributors macro | SUPPORTED | User mentions are anonymized |
Contributors summary macro | SUPPORTED | User mentions are anonymized |
Create from template macro | NOT SUPPORTED | We ignore the macro in the Viewport site so you can use it for internal page creation purposes only. |
Insert excerpt macro (formerly excerpt include macro) | SUPPORTED | |
Excerpt macro | SUPPORTED | Viewport uses the content in your excerpt macro as article meta descriptions. We recommend adding excerpt macros to all pages in order to improve how search engines rank and index your site's articles. See also Optimizing for Search Engines (SEO) – Best Practices |
Expand macro | SUPPORTED | |
Gallery macro | NOT SUPPORTED | |
iFrame | SUPPORTED | The iFrame will only work if it points to a URL that is publicly accessible. Limitation: The height and width dimensions from Confluence do not entirely match the output in Viewport. |
Include page macro | SUPPORTED | For page inclusions from anywhere in your Confluence to show (not just those in your content source)go to Viewport Site Settings → Content inclusions and allow this. |
Jira issues | NOT SUPPORTED | |
Jira legacy | NOT SUPPORTED | The macro no longer works in Viewport due to a change that was introduced by Atlassian. Upon our request, Atlassian has logged an improvement issue to fix the problem. Please refer to JRACLOUD-83193 and click to watch and vote for the issue. |
Label list macro | NOT SUPPORTED | The list is correctly shown but the links don't work. |
Live search macro | NOT SUPPORTED | The theme already comes with search functionality. |
Office Excel macro | NOT SUPPORTED | |
Office Powerpoint macro | NOT SUPPORTED | |
Office Word macro | NOT SUPPORTED | |
Page Index macro | NOT SUPPORTED | |
Page properties macro | SUPPORTED | It’s styled just like any other table in the help center. If you don’t want the macro to appear in your articles, open your macro configurations in Confluence and set the macro to ‘hidden'. |
Page properties report macro | SUPPORTED | Pagination of the report is not supported |
Page tree search macro | NOT SUPPORTED | |
Page tree macro | NOT SUPPORTED | The help center theme already provides a page tree. Please also refer to Why does the table of contents or page tree macro not show in my Viewport site? |
PDF macro | NOT SUPPORTED | Suggested workflow: To add a PDF, drag and drop the PDF file into your Confluence page or use the 'Files & Images' option in the editor toolbar. The inserted file will show as a plain link. Depending on the user’s browser (configuration), clicking the link in Viewport will download the PDF right away, or open a preview in a new tab. |
Popular labels macro | NOT SUPPORTED | The list is correctly shown but the links don't work. |
Profile picture macro | SUPPORTED | |
Recently updated dashboard macro | NOT SUPPORTED | |
Recently used labels macro | NOT SUPPORTED | |
Recent updates macro (formerly Recently Updated macro) | SUPPORTED | Please note:
|
Related labels macro | NOT SUPPORTED | The list will show all related labels but the label links lead to a 404 page. |
Shared link bookmarklet button | NOT SUPPORTED | |
Space list macro | NOT SUPPORTED | |
Status macro | SUPPORTED | |
Table of content macro | NOT SUPPORTED | A table of content is already included with the theme. We recommend using the included functionality. Please also refer to Why does the table of contents or page tree macro not show in my Viewport site? |
Table of content zone macro | NOT SUPPORTED | A table of content is already included within the theme. We recommend using the included functionality. |
Task report | NOT SUPPORTED | |
User list macro | NOT SUPPORTED | |
User profile macro | NOT SUPPORTED | |
Widget connector macro | SUPPORTED | Use the widget connector to embed a video from sources like Youtube or Vimeo to your Viewport site. Is your video from Youtube or Loom? Pasting your public video link into the page and setting the link to ‘Embed' is your quickest way to get videos into your articles. |
Database (entry/value) macro | NOT SUPPORTED |
Editor Features
Editor feature | Status | Comments |
---|---|---|
Emojis in Page Title | NOT SUPPORTED | |
Header Images | NOT SUPPORTED | |
Images | SUPPORTED |
Learn how to Resize and Align Images: https://help-cloud.k15t.com/scroll-viewport/resize-and-align-images |
Image captions | SUPPORTED | |
Videos (uploaded using the Files & images icon or drag and drop) | NOT SUPPORTED | We recommend to embed videos from external (streaming) platforms using the Widget connector macro or editor's Embed links option (see table). See also Why Do My Videos Not Play or Load in My Viewport Site? |
Links | SUPPORTED | Links that point to another domain will open in a new tab. |
Lists (numbered and bulleted) | SUPPORTED | |
Embed links | SUPPORTED | Will show embedded content only for public Youtube and Loom videos. |
Emojis | SUPPORTED | Emojis will display as followed: 🙂🙁😛😀😉👍👎🔒 📱 🔧 Standard emojis will show in the OS/Browser representation. This might deviate from Confluence’s representation of the emoji. |
Tables | SUPPORTED | To optimize readability, especially for large tables, tables in Viewport articles (desktop view) are shown by default slightly wider than text and come with a enlarge button so that the table can be viewed in full screen mode. You also use Confluence’s editor table width options to make tables wider. |
Text formatting | SUPPORTED | Text formatted as inline code follows the same styling as code snippets (monospaced font and grey background), so that it’s distinguishable from paragraph style text. |
Custom Emojis | NOT SUPPORTED | Custom emojis are not supported as Confluence doesn’t support export of these emojis. See also Why Do Custom Emojis Not Show in My Viewport Site? Please use Confluence’s inline images as an alternative. |
Layouts (columns and sections) | SUPPORTED | On mobile, all layouts default to a single column. |
Image links | SUPPORTED | |
Inline images | SUPPORTED | Links on inline images will not work if the link is to a Confluence page. |
K15t macros
This table lists all supported macros that are delivered with K15t apps.
App | What’s supported? |
---|---|
Scroll Imagemaps: maps are shown in articles as configured in the macro, using the custom colors of your theme’s header for the area filling and outline. For a mobile-friendly result, we recommend you tick the checkboxes for ‘responsive’ and ‘show areas’ in the ImageMap editor. That way your linked areas will always be visible in the mobile view. | |
Supported macros:
| |
Supported macros:
Learn more: Define Conditional Content |