Manage Variants and Conditional Content

This article compares how Scroll Versions and Scroll Documents handle variants and conditional content. We'll walk through what these features are and how each app supports them.

Variant Management

Scroll Versions offers built-in variant management. You use attributes and attribute values to define which pages belong to specific variants. This provides fine-grained control over what content is shown to different audiences.

Scroll Documents offers two approaches:

• Basic variant support – Built into the app, enabling you to test and set up two variants per document.

• Variants for Scroll Documents (Extension app) – Unlocks advanced variant management features.

Instead of attributes, Scroll Documents uses standard Confluence page labels to define which pages belong to which variant. This simpler setup makes it more accessible for teams unfamiliar with complex configuration.

To learn more about variant management in Scroll Documents, see: Manage Variants

Conditional Content

Both apps have conditional content macros, which let you show or hide content based on variant rules—for example, displaying a paragraph only for certain user roles or product tiers.

When converting from Scroll Versions to Scroll Documents, your existing Conditional Content macros are automatically converted to Scroll Conditional Content macros. These rely on Confluence page labels to control visibility within variants.

To learn more about this process, see: Conversion with Conditional Content

Preview Variants and Conditional Content

Scroll Versions and Scroll Documents offer different ways to preview your conditional content and articles before publishing.

In Scroll Versions:

• Variants are selected via the variant picker in the Scroll navigation bar.

• When a variant is selected, the page tree greys out pages that aren’t part of that variant.

• Conditional content macros are highlighted differently depending on the variant selected, giving you visual feedback on what will appear in each variant.

In Scroll Documents:

• Use the Variant Preview available in the Scroll Page Details panel.

• See which variant(s) a page belongs to and how conditional content appears for each one—before publishing or exporting.

Summary

The table below summarizes the key differences between how Scroll Versions and Scroll Documents handle variants and conditional content: