# Appearance

The Badge offers various options that allow you to control its look and feel.

For a complete example, refer to the [Appearance Demo of the Badge](https://demos.telerik.com/aspnet-core/badge/appearance).

## Options

The Badge provides the following methods for styling:

* [`Rounded()`](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/layout/badge/appearance#rounded)—Specifies the border radius of the component.
* [`ThemeColor()`](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/layout/badge/appearance#themecolor)—Configures what color will be applied to the component.
* [`Size()`](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/layout/badge/appearance#size)—Defines the overall size of the component.
* [`FillMode()`](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/layout/badge/appearance#fillmode)—Creates a solid or an outline Badge.

### Rounded

The `Rounded` property can be configured through the `Rounded` enumeration. The available values are:

* `Small`—Renders a Badge with a small border radius.
* `Medium`—Renders a Badge with a medium border radius.
* `Large`—Renders a Badge with a large border radius.
* `Full`—Renders a circle shape Badge.

> When not explicitly set, the applied theme controls the default border radius.

> The `None` value is deprecated. Use custom CSS instead.

The following example demonstrates the `Rounded` option of the Badge:

```Razor HtmlHelper
    @(Html.Kendo().Badge()
        .Name("badge")
        .Text("Custom")
        .Rounded(Rounded.Large)
    )
```

```Razor TagHelper
    <kendo-badge name="badge"
        text="Custom"
        rounded="Rounded.Large">
    </kendo-badge>
```

### ThemeColor

The `ThemeColor` option controls the color that will be applied to the rendered Badge.

> Starting with the [**2026 Q1**](https://www.telerik.com/aspnet-core-ui/documentation/backwards-compatibility/2026-backwards-compatibility) release, the Badge component renders with the `primary` appearance by default. Because appearance defaults are now theme-controlled, the `themeColor` option will be `undefined` when not set, but the theme applies the primary styling. To preserve the previous (secondary) look, explicitly set `themeColor: 'secondary'`.

The available `ThemeColor` values are:

* `Primary`—Applies coloring based on the primary theme color.
* `Default`—Applies base theme color.
* `Secondary`—Applies coloring based on the secondary theme color.
* `Tertiary`—Applies coloring based on the tertiary theme color.
* `Info`—Applies coloring based on the info theme color.
* `Success`—Applies coloring based on the success theme color.
* `Warning`—Applies coloring based on the warning theme color.
* `Error`—Applies coloring based on the error theme color.

```Razor HtmlHelper
   @(Html.Kendo().Badge()
        .Name("badge")
        .Text("user")
        .ThemeColor(BadgeColor.Primary)
    )
```

```Razor TagHelper
    <kendo-badge name="badge"
        text="user"
        theme-color="BadgeColor.Primary">
    </kendo-badge>
```

### Size

The `Size` option allows you to set a predefined size for the Badge. The `Size` property can be configured by using the `BadgeSize` enumeration. The available values are:

* `Small`
* `Medium`
* `Large`

> When not explicitly set, the applied theme controls the default size.

```Razor HtmlHelper
    @(Html.Kendo().Badge()
        .Name("badge")
        .Text("JS")
        .Size(BadgeSize.Large)
    )
```

```Razor TagHelper
    <kendo-badge name="badge"
        text="JS"
        size="BadgeSize.Large">
    </kendo-badge>
```

### FillMode

The `FillMode` specifies how the theme colors are applied to the component. The available options are:

* `Solid`
* `Outline`

> When not explicitly set, the applied theme controls the default fill mode.

```Razor HtmlHelper
    @(Html.Kendo().Badge()
        .Name("badge")
        .Text("JS")
        .FillMode(BadgeFill.Outline)
    )
```

```Razor TagHelper
    <kendo-badge name="badge"
        text="JS"
        fill-mode="BadgeFill.Outline">
    </kendo-badge>
```

## See Also

* [Badge Client-Side API](https://docs.telerik.com/kendo-ui/api/ui/badge)
