> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usertick.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Usertick runs surveys on websites, by link, by QR code and by email, and collects every response in one inbox with reports, dashboards and workflows. The REST API lives at https://app.usertick.com/api/public/v1 and uses Bearer API keys or OAuth access tokens; the JavaScript SDK is the @usertick/snippet package on npm.

# Variants

> Show a different version of a survey to some respondents, or test a change on a share of them and compare the results. Variants are on the Business plan.

Variants let you show another version of a survey's content to the respondents who match its conditions. You can use them to adapt a survey for a country or a device, or to A/B test a question's wording on a share of respondents. Respondents who match no variant see **Base**, the survey as you built it.

You manage variants from the **Variants** menu in the editor's header, to the left of the language menu. The menu shows the version you are editing, which is **Base** by default.

![The Variants menu open while the Mobile layout variant is being edited: Add variant, Base, and two variants with their change counts and menus, above the variant banner with Back to Base](https://mintcdn.com/usertick/b7hHAD5bKMN_XhRp/images/surveys-variants.png?fit=max\&auto=format\&n=b7hHAD5bKMN_XhRp\&q=85\&s=fd8a52b2660337d8f67aeb6d69110784)

The Variants menu

## Add a variant

1. In the editor's header, open the **Variants** menu and select **Add variant**.
2. In **New variant**, enter a **Name**.
3. Select **Add condition** and choose who sees this version. On a website survey, **Add trait rule** under **User traits** adds a rule over the visitor's traits. When you add more than one condition, **Match** sets whether **All conditions** or **Any condition** must apply, and the line at the top of the dialog sums up who sees the variant.
4. Select **Create variant**, and the editor switches to the new variant.

![The New variant dialog with its Who sees it line, a Name, Match, a Country condition set to Germany, a Share of visitors condition at 50%, Add condition, User traits and Create variant](https://mintcdn.com/usertick/b7hHAD5bKMN_XhRp/images/surveys-variant-rules.png?fit=max\&auto=format\&n=b7hHAD5bKMN_XhRp\&q=85\&s=5bbfe5a1d3417c3c21f1eb0a9e9e0981)

New variant

You can choose from these conditions:

* **Country** covers respondents from the selected countries, or from everywhere else.
* **Device** limits the variant to desktop, tablet or mobile.
* **Share of visitors** picks a random percentage of respondents. Each respondent keeps the same result, and the shares of all variants add up to 100% at most.
* **Page** works on website surveys and matches respondents on matching pages.
* **User traits** matches website visitors whose traits, passed with `Usertick.identify`, match the rule, and you add it with **Add trait rule**.

A survey can hold up to 8 variants, each with up to 5 conditions. Each respondent sees the first variant in the list whose conditions match, so the order matters.

## Edit a variant

While a variant is selected, a banner shows which one you are editing, and the changes you make to questions, design, texts and settings in the **Survey** step apply only to that variant. Every version shares the **Channel**, **Targeting**, **Email**, **Publish** and **Share** steps, so they are locked in a variant.

* A setting changed in the variant is marked **Different in this variant**, and **Reset** returns it to the Base value.
* **Hide in this variant** and **Show in this variant** remove a Base question from the variant or bring it back. A question you add while editing a variant exists only in that variant.
* Changing a question's type in a variant creates a separate question for the variant, so answers to the two types stay apart.
* **Back to Base** takes you back to the Base survey.

In an email survey, every variant keeps the first question unchanged, because that question is part of the email itself.

## Manage variants

Each variant's menu in the **Variants** menu offers **Edit rules**, **Edit content**, **Move up**, **Move down**, **Duplicate**, **Apply to Base** and **Delete**.

* **Apply to Base** adds the variant's changes and questions to Base and removes the variant.
* **Delete** removes the variant's conditions, changes and own questions, and the responses it already collected are kept.
* Changing the shares of a live survey moves some respondents to another version, so results from before and after the change mix.

## Test wording from AI suggestions

When AI suggests new wording for a question, **Test as variant** creates a variant that shows the new wording to a share of respondents, or adds it to a variant you already have. See [Improve the wording with AI](https://docs.usertick.com/surveys/questions.md#improve-the-wording-with-ai).

## Compare the results

When a survey has variants, its [Results](https://docs.usertick.com/results/overview.md#variants) page adds a **Variants** tab that compares each version, and the [inbox](https://docs.usertick.com/results/inbox.md) can filter and group responses by **Variant**.

## Who can do this

Creating and editing variants requires the **Manage surveys** permission and the Business plan. On a lower plan, a published survey keeps running its variants, and you can still delete an existing variant or apply it to Base. Comparing variant results works on every plan.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.