Add, hide, rename and remove shadcn/ui variants and sizes in DS Manager, and style hover, focus, pressed, disabled and other component states.
Variants, sizes and states are dropdowns at the top of a component's Style tab. Each menu picks which specimen you edit, and the Variant and Size menus are also where you add values of your own.
On a component page, the Style tab opens with the root part selected and every menu on its default. The rows depend on the component: a Button has Variant and Size, an Avatar has Size, a Separator has Orientation, and a component with no variants has none.
An edit changes only the variant, size and state you have picked. Colors, borders and radius go to the picked variant, and height, padding and text size go to the picked size. With Variant on outline, a new background or radius changes only outline buttons. Clicking a matrix cell or ⌘-clicking a specimen sets the menus for you. See Editing components for more on selecting parts.

brand or brand-subtle.The menus switch to the new value, the canvas selects it, and you style it like any other. It is exported as a real cva key, so in your project you write <Button variant="brand">.
On a custom component, the Size menu's Add new… opens this same dialog for a size.
The dialog explains a name it refuses, for example "Variant name is required." or "Brand" must be kebab-case, e.g. "brand" or "brand-subtle". A name the axis already has is refused too.
Only the Variant and Size axes take new values. Axes like Orientation have no Add new… row. You can also start from the command menu: press ⌘K and run "Add a variant to Button…".
On a built-in component, you add a size by picking a size to start from and a scale. This works on the components that already have a Size menu, such as Button, Toggle and Item. Input, Textarea, Badge and Kbd can get sizes too, and once you add one, the installed component takes a real size prop.

The canvas then selects the new size and scrolls it into view. Adding both Controls sizes at once is one undo step.
The command menu has "Add a size to Button…" for the same dialog. Custom components keep the dialog from Adding a variant, with Clone from.
A built-in value you don't want in your system, such as Button's outline, can be hidden without breaking code that still uses it.

A hidden value leaves the menus and the matrix. Anything that still uses it draws as its replacement: the other components, ProBlocks, your custom components and the installed code. In your project, variant="outline" keeps working and looks like the value you picked. A line under the menus, such as "1 variant hidden" or "2 sizes hidden", opens the dialog again.
To bring a value back, open Manage variants and click Show outline again on its row. Hiding, showing and changing Use instead are each one undo step.
Custom components don't have hiding.
Values you added sit in the menus next to the built-in ones, and Manage variants lists them with a Custom tag.
A rename changes the cva key. Code in your project that still uses the old name has to be updated by hand.
When a custom component uses a value you added, its row in Manage variants says so, such as "Used in Rating's code.", with the file and line on hover. After a rename or removal that leaves a custom component on the old name, a warning names it and ends "Ask the agent to update it."
The built-in shadcn/ui variants can't be renamed or removed, because components in your project rely on them. Restyle them, or hide them instead.
The State menu lists Default, then only the states that the component's rules already style:
You can't add a state that the component does not have. A component with no states shows no State menu.
Under a divider, the same menu lists parts drawn with ::before and ::after, such as Underline and Marker, when the component has them.
hover:bg-primary/80 or disabled:opacity-50.DS Manager shows Selected, Open, Disabled and Invalid on the canvas while you edit them. Hover and focus can't be held on, so the rail tells you to "Hover the element on the canvas to see this state." or "Tab to the element on the canvas to see this state."
A control whose value comes from the resting element is dimmed. It is still editable: typing a value gives the state its own.
To see or add the raw classes for a state, open the Utilities tab. Classes are grouped by state there, and + Add in a state group writes the prefix for you.