Supported Macros and Features

Question

I am trying to use a macro in a translated space, and it's not working properly. What's the reason, and how do I fix it?

Answer

In translated spaces, every translated page actually contains all languages in a space within specific macros. This is how Scroll Translations provides multiple language versions of the same page. Of course, Confluence 'sees' those translated pages as normal pages with all separate language content in it – and this often causes certain third-party apps and macros to render the content in unexpected ways.

In Scroll Versions and Translations, we provide compatible alternatives of the macros that are necessary for documentation authoring spaces (see the reference table below for details). Please keep in mind, that macros generally have more data to process in translated spaces, which can lead to higher cache requirements or longer load times.

However, it's simply not possible for us to build alternative versions of every macro that behaves unexpectedly in translated spaces – the support for certain apps and macros is considered a feature of Scroll Translations. If a certain macro or app doesn't work, this is not a bug.

Macro compatibility

Built-in macros

App/macro name	Compatibility	Notes
Page Properties macro		Starting with 3.8.8 release in combination with Confluence 6.6.1 and later, this macro is aware of space versions and languages.
Page Properties Report macro	/	Starting with 3.8.8 release in combination with Confluence 6.6.1 and later, this macro is aware of space versions and languages, but does not support pagination, which can lead to longer load times. Some macro parameters prevent it from working correctly in translated spaces: VSN-4176
Include macro		Use Include Plus in translated spaces
Excerpt Include macro		Use Excerpt Include Plus in translated spaces
Scroll Metadata macro
Page Tree macro		Use Scroll Page Tree in translated spaces
Children Display macro
Content by Label macro		Some macro parameters prevent it from working correctly in translated spaces: VSN-4176
Activity Stream macro
Anchor macro
Attachments macro
Blog Posts macro
Change history macro		Shows the page history of a particular translated page
Chart macro
Cheese macro
Code Block macro
Column macro
Content by User macro
Content Report Table macro		Might display default language titles.
Contributors macro
Contributors Summary macro
Expand macro
Favorite Pages macro		Might display default language titles.
Gallery macro
Labels List macro
Livesearch macro		Displays page titles the way Confluence "sees" them (default language)
Loremipsum macro
Multimedia macro
Navigation Map macro		Might display default language titles.
No Format macro
Note macro
Page Index macro		Might display default language titles.
Page Tree Search		Might search & display default language titles.
Panel macro
Popular Labels macro
Recently Updated macro		Might display default language titles.
Roadmap Planner macro
Search Results macro		Might display default language titles.
Section macro
Tip macro
Warning macro

Third-party macros

App/macro name	Compatibility	Notes
Gliffy
Balsamiq mockup
Draw.io
Multi Excerpt macro		See how Content Reuse is done in spaces with Scroll Versions and Translations