# Variants (UI)

The **Variants** UI element allows to switch between objects contained within a [Variants tool](/documentation/3d-configurator/variants.md). To use this feature, first, add a **Variants** tool to the project, then assign it as the source in the **Variants UI element** settings.

Object switching within **Variants** group can also be configured using the [Variants interaction](/documentation/3d-configurator/interactions/actions/variants.md) for automated transitions.

#### Settings

Variants (UI) can be displayed in two styles:<br>

* **Dropdown** — a standard selection menu.

* **Swatch** — a visual selection with customizable thumbnails.

* **Auto-hide** — Hides the UI element when the object is hidden.

**Additional settings for Swatch style:**<br>

* **Display name** — Show the selected object name.
* **Alignment** — Set thumbnail alignment.
* **Spacing** — Define the spacing between thumbnails.
* **Swatch size** — Set the thumbnail size.
* **Swatches** — Upload a custom design for each variant.\
  \
  ![](/files/tu0aSkzSuxDsPIjfBgF3)

#### Layout

* **W** — Defines the width of the **Variants** element.
* **H** — Defines the height of the **Variants** element.<br>
* **Fixed** — Sets a fixed size in pixels.
* **Fill** — Adjusts the size based on the parent element (**Floating UI** or **Container**).<br>
* **Padding** — Sets vertical and horizontal padding within the element.
* **Corner radius** — Defines the rounding radius for the dropdown field and swatches.<br>

#### Stroke

* **Thickness** — Defines the stroke thickness for the dropdown field.
* **Default color** — Sets the default stroke color (if disabled, the stroke will be transparent).
* **Hover color** — Changes the stroke color on hover.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.vectary.com/documentation/3d-configurator/floating-ui/variants-ui.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.