Variants
Keep parallel versions of one manual, such as v1 and v2 or Basic and Pro, each with its own topics and web address.
Only an Owner or Admin can add, rename or remove variants.
When to use variants
A variant is a parallel version of a document. Each variant has its own table of contents, its own topics and its own web address, while sharing the document's settings, languages and theme. Use variants when readers need a different version of the same manual:
- Product versions: v1, v2, v3.
- Editions or models: Basic and Pro, X100 and X200.
- Audiences: Admins and End users.
Every document starts with one variant, the default variant. Its slug is the document's address. Other variants get their own address. Readers switch between variants from a menu in the published document.
If the content is truly different, a separate document is usually simpler. To share one topic across several documents, use linked topics instead. See Reuse content.
Add a variant
- Open the document and select Variants in the left menu.
- Select + Add Variant.
- In Variant name, enter a name readers will recognize, for example v2.
- In Slug, enter the address for this variant, for example
v2. - In Copy from, choose an existing variant to start from its topics, or None (Empty variant) to start empty.
- Select Add.

Copied topics arrive as unpublished drafts, taken from the latest draft of each source topic. Publish them in the new variant before readers can see them.
Edit a variant's topics
- Open the document's Edit Content page.
- In the top bar, switch to the variant you want to edit.
- Edit and publish topics as usual. Changes in one variant don't affect the others.
Rename a variant or change its slug
- On the Variants page, select the pencil icon next to the variant.
- Change the name or the slug.
- Select the check mark to save.
- If you changed the slug of a published variant, Sonat asks Change the live URL of this variant?. Select Change the URL to confirm.
When a document has only one variant, you can also change its slug in Document Settings › General. With several variants, change slugs here.
Choose the default variant
The default variant is what readers see when they open the document's address. To change it, select the star next to another variant. The filled star marks the current default.
Remove a variant
- Select the trash icon next to the variant.
- Confirm in Delete version?.
Removing a variant deletes its topics. You can't remove the default variant: make another variant the default first.
If something goes wrong
"Can't remove default variant."
Select the star on another variant to make it the default, then remove this one.
"Duplicate slug" or "Duplicate title"
Each variant in a document needs its own name and slug. Choose different ones.
"Can't add more topics" when adding a variant
Copying a variant copies its topics, and they count toward your plan's limit. Start from None (Empty variant), or upgrade. See Plans and limits.
Readers don't see the new variant
Topics in a new variant start as drafts, including copied ones. Switch to that variant in the top bar and publish its topics.