Skip to main content
Skip table of contents

Best Practices: Setting up Variant Rules

Learn how to best define your variant rules to create the outcomes you need.

Variant rules determine which pages of your document end up being included or excluded from a specific variant.

This article summarizes:

  • some tips and tricks for how to best define variant rules,

  • and helps you correct invalid rules.

Create a Variant That Includes All Pages

If one of your variants should include all pages of your documentation page tree, you could create a new label and add it to all pages of your page tree.

To save time, we recommend setting up the following rule instead:

  1. Select “does not have label.”

  2. In the label field, enter a completely new label name (e.g. one that matches your variant name) or a label that isn’t or won’t be used in any other variant rule.

Troubleshooting Invalid Rules



The variant page tree is empty, because the root page is not in the variant. 

The root page needs to be included in all variants. To do you have two options:

Option 1

  • Try to remove a rule

Option 2

  • Add a label to the root page that matches one of your rules.

Some pages match the variant rule(s) but are excluded because not all their ancestors are in the variant.

Add a label to the parent page (ancestor) as well.

JavaScript errors detected

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

If this problem persists, please contact our support.