Skip to main content
Skip table of contents

Define and Edit Variants

In this article, you will learn how to define and edit a variant. This is the first step to start conditionalizing the content in your document, so you can deliver tailored content to different audiences.

We recommend defining your variants before you start versioning your document. If your document already includes versions other than the Working Version, you should make sure that your variant definition applies to all versions that require the variants.

Define a New Variant

First, navigate to the Variants Manager.

  1. Navigate to the Document Library of the space where you have created your Scroll Documents.

  2. Click on the document card to navigate to the Document Manager.

  3. Click Manage.

  4. Select Variants.

To start creating a new variant definition, click on New Variant in the top-right corner of the screen. In the New Variant dialog follow these steps:

  1. In the field “Variant name” enter a descriptive name for your variant.

  2. Under “Rules”, you can define criteria to determine which pages are included or excluded from the variant.

    1. Rules are based on:

      1. "Has label": Include pages that have a specific label.

      2. "Does not have label": Exclude pages that have a specific label.

    2. Combine Multiple Rules:

      1. If you add multiple rules, use the dropdown to choose how they should be applied:

        1. Match all rules (AND): Only include pages that satisfy all the specified conditions.

        2. Match any rule (OR): Include pages that satisfy any of the specified conditions.

  3. To add nested rules under an existing rule, hold the Alt/Option key while clicking the (plus) (Add rule) button.
    (info) Please note: Nested rules are only available if you have extended Scroll Documents with Variants for Scroll Documents.

    1. For each level of nested rules, use the dropdown menu to specify whether any or all of the rules must be true.

    2. In general, it’s best to keep variant rules as simple as possible to achieve your desired results, however sometimesTo learn more about using nested rules, see our tutorial: Tutorial: Define and Edit Multiple Variant Rules

Use the dynamic page tree preview on the right of the dialog to check which pages in your document will be part of the variant based on the rules that you define. Pages whose titles appear greyed with a strike-through are not included in the variant.

Use the version switcher above the preview field to view the page trees of all your versions.

4. Click Create.

Your variant is now defined. From here on, any content added to your document that matches the rules of the variant will automatically be considered part of the variant.

Learn how to create content that matches your variant rules in Define Conditional Content.

Edit and Delete a Variant

The Manage Variants action in the Document manager always indicates the number of variants you have currently set up for your document.

After creating a variant, you can always go back to the Variants Manager for an overview of all created variants.

From the variants list you can:

  • Click the pen icon to edit the name and/or rules of a variant.

  • Click the trash icon to delete a variant.

  • Rearrange your variants in the desired order by simply dragging and dropping them. The variant picker will reflect the new order.

JavaScript errors detected

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

If this problem persists, please contact our support.