New to Telerik UI for Blazor? Download free 30-day trial

DropDownButton Icons

The <TelerikDropDownButton> and <DropDownButtonItem> provide an Icon parameter that allows you to add an icon to the main button and all secondary action items.

The Icon parameter type is object and it accepts:

How to use icons in Telerik Blazor DropDownButton

<TelerikDropDownButton Icon="@FontIcon.User">
    <DropDownButtonContent>Telerik Font Icon</DropDownButtonContent>
        <DropDownButtonItem Icon="@SvgIcon.Gear">Telerik SVG Icon</DropDownButtonItem>
        <DropDownButtonItem Icon="@CustomIconClass">Custom Icon</DropDownButtonItem>
        <DropDownButtonItem> <TelerikLoader /> Custom markup </DropDownButtonItem>

    /* Third-party icon libraries should provide these styles out-of-the-box. */

    .my-icon {
        width: 1em;
        height: 1em;
        font-size: 16px;
        background: purple;

@code {
    private string CustomIconClass { get; set; } = "my-icon";

Best Practices for Custom Icons and Images

  • You can add custom icons and images through additional markup inside the <DropDownButtonContent>, where the text is.

  • Images used as icons should generally be small enough to fit in a line of text. The primary button is an inline element and is not designed for large images. If you want to use big icon buttons, consider one of the following options:

    • Define a Class for the button that provides height and width. The width and height can be set to auto or to a value in px. When using a static value, it must be sufficient to accommodate the icon.
    • Adding your own HTML inside the <DropDownButtonContent>, something like: <DropDownButtonContent><img style="width: 400px; height: 400px;" src="my-icon.svg" />some text</DropDownButtonContent>

See Also

In this article