Question
I am trying to use a macro in a versioned space, and it's not working properly. What's the reason, and how do I fix it?
Answer
In versioned spaces, every edited versioned page is an actual Confluence page. This is how Scroll Versions allows multiple different versions of the same page. Likewise, pages with Conditional Content for example display different content for different variants, despite all of it being in one page. Of course, Confluence 'sees' those pages as normal pages – and this often causes certain features, third-party apps or macros to behave in unexpected ways.
In Scroll Versions, we provide versions-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 versioned 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 versioned spaces – the support for certain features, apps and macros is considered a feature of Scroll Versions. 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. |
|
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, but does not support pagination, which can lead to longer load times. Some macro parameters prevent it from working correctly in versioned spaces: VSN-4176
|
|
Include macro |
|
Use Include Plus in versioned spaces |
|
Excerpt Include macro |
|
Use Excerpt Include Plus in versioned spaces |
|
Scroll Metadata macro |
|
|
|
Page Tree macro |
|
Use Scroll Page Tree in versioned spaces |
|
Children Display macro |
|
The rich content excerpt is only showing text content in versioned spaces. |
|
Content by Label macro |
|
Some macro parameters prevent it from working correctly in versioned spaces: VSN-4176 |
|
Activity Stream macro |
|
|
|
Anchor macro |
|
|
|
Attachments macro |
|
|
|
Blog Posts macro |
|
|
|
Change history macro |
|
Shows the page history of a particular versioned page |
|
Chart macro |
|
|
|
Cheese macro |
|
|
|
Code Block macro |
|
|
|
Column macro |
|
|
|
Confluence Page Gadget |
|
Select a specific versioned page or a public view one |
|
Confluence QuickNav macro |
|
The search field would search across all pages and versions. If you would like to search in a specific version, please refer to Scroll Search. |
|
Content by User macro |
|
|
|
Content Report Table macro |
|
Displays pages from all versions to which the label specified in the macro parameters is applied |
|
Contributors macro |
|
|
|
Contributors Summary macro |
|
|
|
Expand macro |
|
|
|
Favourite Pages macro |
|
Displays pages from all versions |
|
Gallery macro |
|
|
|
Labels List macro |
|
|
|
Livesearch macro |
|
Displays page titles the way Confluence "sees" them (as a permalink) |
|
Loremipsum macro |
|
|
|
Multimedia macro |
|
|
|
Navigation Map macro |
|
Displays pages from all versions |
|
No Format macro |
|
|
|
Note macro |
|
|
|
Page Index macro |
|
Displays links to pages in the Public View |
|
Page Tree Search |
|
The search displays all the versioned pages |
|
Panel macro |
|
|
|
Popular Labels macro |
|
|
|
Recently Updated macro |
|
Displays pages from all versions |
|
Roadmap Planner macro |
|
|
|
Search Results macro |
|
Searches and displays pages from all versions |
|
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 |