Skip to main content

Conversion with Conditional Content

Conditional content macros in Scroll Versions enable you to control the visibility of content based on specific conditions. This article explains what happens to Conditional Content macros after a conversion to Scroll Documents and its extension app, Variants for Scroll Documents.

Transformation and Limitations

When you convert to Scroll Documents, your Conditional Content macros are transformed into Scroll Conditional Content macros, the Scroll Documents counterpart.

It's important to note that Scroll Documents and Variants for Scroll Documents do not support inline macros. This means that any inline Conditional Content macro you migrate, as well as any new Scroll Conditional Content macros you create, will be transformed/created as blocks. As a result, the content within each Scroll Conditional Content macro will be displayed on a new line.

We have plans to enhance the display of conditional content by adding highlights to the macros. For more information, refer to: DOCS-170

To learn more about the differences when managing variants and conditional content between Scroll Versions and Scroll Documents, see: Manage Variants and Conditional Content

If You Convert with Inline Conditional Content

During the conversion process, Scroll Versions provides you with the option to “Preserve inline Conditional content macros.”

You only need to select this option if you have inline Conditional Content macros on the same line as other text content.

If checked, the conversion tool will detect the paragraph around one or multiple inline conditional content macros and make the whole paragraph conditional, with different inline content in each of them. This results in equivalent output when publishing or exporting the content, the page view of the content might look less clear. Below are some examples of conditional content macros migrated with and without the option to preserve inline conditional content.

Conditional content before conversion:

Conditional Content macros before conversion to Scroll Documents

The following sentence contains two inline condition content macros

Conditional content after conversion:

Conditional Content macros after conversion to Scroll Documents

Editor view after conversion without preserving inline conditional content (left) and with preserving conditional content (right)

If you have multiple variants, you'll see the converted macros stacked on top of each other in the Confluence page view. However, when using Scroll Viewport, the Document Reader, or exporting with Scroll Exporters, only the content from the selected variant will be visible.

JavaScript errors detected

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

If this problem persists, please contact our support.