# Component Variant

> One version of a part, like a filled or plain button. The designer picks it.

**Field:** Design  
**Category:** User Interface  
**Also known as:** Variant, Button Variant, Component Variants

## Think of it like

It is like a T-shirt in red, blue or green. Same shirt, a different version.

## Definition

A component variant is one version of a part, chosen when the screen is designed. A button might come as filled, plain or danger, and in small or large sizes. Variants are picked by the designer for a job, while states change as people use the part. Keeping variants in one component stops a pile of near-copies.

## Example

A form uses a filled Save button and a plain Cancel button. Both are variants of one button.

## Why it matters

One part can do many jobs. It still looks like one family.

## Common mistake

Mixing up variants and states. A danger button is a variant; a pressed button is a state.

## Three principles

- **Chosen while designing.** Not while using.
- **One part, many versions.** Size, style, purpose.
- **Not a state.** States change in use.

## Related terms

- [Design Component](https://learn.benibix.com/term/design/design-component)
- [Component State](https://learn.benibix.com/term/design/component-state)
- [Button](https://learn.benibix.com/term/design/button)

## Taught in

- [UI Components Basics](https://learn.benibix.com/learn/design-user-interface/ui-components-basics): UI Components, 1/14

---

Source: https://learn.benibix.com/term/design/component-variant
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
