Skip to main content
Skip table of contents

Using Macros


With macros, you can add dynamic content and extra functionality to your help center pages.

Learn more about macros.

Macros Integrated into the Help Center theme

There are a number of macros that are not rendered similar to how they look or work in Confluence, but are integrated into the theme either by being embedded into the navigation or changing the visual output to match the style.

  • Code: The code macro renders with source code highlighting and a one-click copy button. Source code highlighting supports HTML and XML and since Scroll Viewport 2.18.3 also supports Bash, C, C++, C#, git, ASP.NET, Java, Json, Perl, PHP, Python, Ruby, SQL, Velocity, YAML. To use source code highlighting the language must be set in the code macro.

  • Display children: This macro renders like an accordion menu with each entry representing a child page. Set children depth to 2 to make the accordion expand.

  • Excerpt: Content within the excerpt macro is used as a page description in the Help Center theme whenever the page is represented as a tile.

  • Content by label: A list of the labelled pages appears in the right sidebar, below the ToC. This macro is particularly useful to list related articles.

  • Table of contents: This macro is omitted in the Help Center theme, as an interactive ToC is part of every article page.

Macro Errors

To optimize your user's help experience, if a macro is retuning an error, nothing is displayed to users who aren't logged in. For Confluence users who are logged in, the error displays along with a link to switch back to Confluence so they can fix the issue.

Not Supported Macros

These are the macros that are not compatible with the Help Center theme:

Because there are so many macros available, the Help Center theme supports the most common use cases. To request support for another macro, please contact us at help@k15t.com.


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.