# Icon Overrides

As of the R3 2026 release, Telerik UI for ASP.NET Core supports overriding icons rendered by components through the fluent `SetIcons` configuration API. The overrides replace icons both on the server (for components that render HTML on the server, such as Menu, Grid, PanelBar, and ContextMenu) and on the client (for components that create icons dynamically via JavaScript). The feature works with both SVG icons and Font icons, regardless of the configured `IconType`.

## Configuring Icon Overrides

Icon names are normalized before they are matched, so both kebab-case (`chevron-right`) and PascalCase (`ChevronRight`) names are accepted. Using kebab-case is recommended for consistency. Component scopes use the `TelerikComponents` enum. The `Global` and `Component` methods can be chained within one `SetIcons` call.

Render the icon overrides in the layout so they are registered before the widgets initialize:

```Razor
@Html.Kendo().OverrideIcons()
```

```C#
using Kendo.Mvc;
using Telerik.SvgIcons;

services.AddKendo(options =>
{
    options.SetIcons(icons => icons
        .Global(global => global
            .Override("chevron-right", "arrow-end-right"))
        .Component(TelerikComponents.ContextMenu, component => component
            .Override("chevron-right", SVGIcons.CaretAltRight)
            .Override(SVGIcons.ChevronDown.Name, SVGIcons.CaretAltDown)));
});
```

The `Override` method accepts either a string or an `ISvgIcon` object. Use an `ISvgIcon` object to provide a completely custom SVG icon:

```C#
using Telerik.SvgIcons;

services.AddKendo(options =>
{
    options.SetIcons(icons => icons
        .Global(global => global
            .Override("chevron-right", SVGIcons.CaretAltRight)
            .Override(SVGIcons.ChevronDown.Name, SVGIcons.CaretAltDown)));
});
```

## See Also

* [SVG Icons](https://www.telerik.com/aspnet-core-ui/documentation/styles-and-layout/sass-themes/svg-icons)
* [Font Icons](https://www.telerik.com/aspnet-core-ui/documentation/styles-and-layout/sass-themes/font-icons)
* [Using an Older Telerik.SvgIcons Version with the Icon Overrides Service](https://www.telerik.com/aspnet-core-ui/documentation/knowledge-base/use-older-svgicons-4-package)
