Breadcrumbs

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

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

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

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png / https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/warning.png

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

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/warning.png

Use

Include Plus

in translated spaces

Excerpt Include macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/warning.png

Use

Excerpt Include Plus

in translated spaces

Scroll Metadata macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Page Tree macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/warning.png

Use Scroll Page Tree in translated spaces

Children Display macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Content by Label macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Some macro parameters prevent it from working correctly in translated spaces: VSN-4176


Activity Stream macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Anchor macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Attachments macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Blog Posts macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Change history macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Shows the page history of a particular translated page

Chart macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Cheese macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Code Block macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Column macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Content by User macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Content Report Table macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/warning.png

Might display default language titles.

Contributors macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Contributors Summary macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Expand macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Favorite Pages macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/warning.png

Might display default language titles.

Gallery macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Labels List macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Livesearch macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/warning.png

Displays page titles the way Confluence "sees" them (default language)

Loremipsum macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Multimedia macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Navigation Map macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/warning.png

Might display default language titles.

No Format macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Note macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Page Index macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/warning.png

Might display default language titles.

Page Tree Search

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/warning.png

Might search & display default language titles.

Panel macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Popular Labels macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Recently Updated macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/warning.png

Might display default language titles.

Roadmap Planner macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Search Results macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/warning.png

Might display default language titles.

Section macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Tip macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Warning macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Third-party macros

App/macro name

Compatibility

Notes

Gliffy

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Balsamiq mockup

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Draw.io

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png


Multi Excerpt macro

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/error.png

See how

content reuse

is done in spaces with Scroll Versions and Translations