# Change the Default Icons

Applications often require using custom icons to align with a design system, branding requirements, or an existing icon set.

Kendo UI for Angular lets you override default icons at different scopes by providing a custom icon service. Choose the scope that matches the level of customization you need.

<table>
    <colgroup>
        <col width="180" />
        <col />
        <col />
    </colgroup>
    <thead>
        <tr>
            <th>Override scope</th>
            <th>When to use</th>
            <th>Example</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td><a href="#override-icons-per-application">Per application</a></td>
            <td>Apply the same icon customization across all Kendo UI components at the application level.</td>
            <td>Replace the default Kendo <code>filter</code> icon with a custom filter icon across the entire application.</td>
        </tr>
        <tr>
            <td><a href="#override-icons-per-component-type">Per component type</a></td>
            <td>Customize icons for a component type while leaving all other components unchanged.</td>
            <td>Replace the <code>filter</code> icon in every Grid while keeping the default <code>filter</code> icon in all other components.</td>
        </tr>
        <tr>
            <td><a href="#override-specific-icons-with-css">Single icon</a></td>
            <td>Customize single icons for a specific component instance without affecting any others.</td>
            <td>Replace the <code>expand</code>/<code>collapse</code> icons in a specific Grid instance.</td>
        </tr>
    </tbody>
</table>

## Prerequisites

Providing a custom  [`IconSettingsService`](https://www.telerik.com/kendo-angular-ui-develop/components/icons/api/iconsettingsservice) is the first step in overriding default icons.

The scope of the override depends on where you provide the service in the Angular dependency injection hierarchy - at the application level or within a component injector.

```ts Application scope
// main.ts
bootstrapApplication(AppComponent, {
    providers: [
        { provide: ICON_SETTINGS, useValue: { type: 'svg' } }, // or 'font'
        { provide: IconSettingsService, useClass: MyIconService },
    ],
});
```

```ts Specific component
@Component({
    selector: 'my-component',
    standalone: true,
    providers: [
        { provide: ICON_SETTINGS, useValue: { type: 'svg' } }, // or 'font'
        { provide: IconSettingsService, useClass: MyIconService },
    ],
})
export class MyComponent {}
```

## Override Icons Per Application

You can override default icons for all Kendo UI components that use the application-level icon service. This is the most common scenario when integrating a design system, using a [third-party icon library](https://www.telerik.com/kendo-angular-ui-develop/components/icons/third-party-libraries), or applying a company-wide icon set.

<TabStrip>
<TabStripTab title="SVG Icons">

Extend [`IconSettingsService`](https://www.telerik.com/kendo-angular-ui-develop/components/icons/api/iconsettingsservice) and override `getSvgIcon` to return icons from your library. Call `super` for unmapped icons. Browse the [SVGIcon List](https://www.telerik.com/kendo-angular-ui-develop/components/icons/svgicon/svgicon-list) to find the key of the icon you want to override.

```ts Icon Mapping
import * as allSVGIcons from '@progress/kendo-svg-icons';

const ICON_MAP: Record<string, SVGIcon> = {
    'chevron-down': allSVGIcons.minusIcon,
    'chevron-up': allSVGIcons.plusIcon,
};
```

```ts Service Implementation
@Injectable()
export class MyIconService extends IconSettingsService {
    public override getSvgIcon(svgIconName: string): SVGIcon {
        return ICON_MAP[svgIconName] || super.getSvgIcon(svgIconName);
    }
}
```

Click the swap icon button in the demo below to see the default component icons replaced with other icons from the Kendo SVG icon library.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/icons/custom-icons/custom-svg/source.txt)

</TabStripTab>
<TabStripTab title="Font Icons">

Extend [`IconSettingsService`](https://www.telerik.com/kendo-angular-ui-develop/components/icons/api/iconsettingsservice) and override `getCustomFontIconClass` to return CSS class strings from your font library. Call `super` for unmapped icons. Browse the [Font Icon List](https://www.telerik.com/kendo-angular-ui-develop/components/icons/icon/icon-list) to find the key of the icon you want to override.

```ts Icon Mapping
const ICON_MAP: Record<string, string> = {
    'x': 'fa-solid fa-xmark',
    'search': 'fa-solid fa-magnifying-glass',
};
```

```ts Service Implementation
@Injectable()
export class MyIconService extends IconSettingsService {
    private readonly iconMap: { [key: string]: string } = {
        'x': 'fa-solid fa-xmark',
        'search': 'fa-solid fa-magnifying-glass',
    };
    public override getCustomFontIconClass(iconName: string): string {
        return this.iconMap[iconName] || super.getCustomFontIconClass(iconName);
    }
}
```

Click **Swap Icons** in the demo below to toggle between the default Kendo font icons and the custom overrides across the Chat, Grid, and TreeList.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/icons/custom-icons/custom-font/source.txt)

</TabStripTab>
</TabStrip>

## Override Icons per Component Type

You can override icons for all instances of one Kendo UI component while keeping the default icons in other components unchanged. This is useful when you want to customize a specific component icons without affecting other components that use the same icons.

<TabStrip>
<TabStripTab title="SVG Icons">

Extend [`IconSettingsService`](https://www.telerik.com/kendo-angular-ui-develop/components/icons/api/iconsettingsservice) and override `getSvgIcon` to return a different icon for a specific component type. Call `super` for unmapped icons. Browse the [SVGIcon List](https://www.telerik.com/kendo-angular-ui-develop/components/icons/svgicon/svgicon-list) to find the key of the icon you want to override.

```ts Icon Mapping
import * as allSVGIcons from '@progress/kendo-svg-icons';

const COMPONENT_ICON_MAP = {
    grid: {
        'chevron-down': allSVGIcons.minusIcon,
        'chevron-up': allSVGIcons.plusIcon,
    },
};
```

```ts Service Implementation
@Injectable()
export class MyIconService extends IconSettingsService {
    public override getSvgIcon(iconName: string, component?: string): SVGIcon {
        return COMPONENT_ICON_MAP[component]?.[iconName] || super.getSvgIcon(iconName, component);
    }
}
```

The following example overrides the Grid icons only leaving the same in the TreeList unchanged.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/icons/custom-icons/component-type-svg/source.txt)

</TabStripTab>
<TabStripTab title="Font Icons">

Extend [`IconSettingsService`](https://www.telerik.com/kendo-angular-ui-develop/components/icons/api/iconsettingsservice) and override `getCustomFontIconClass` to return a different font icon class for a specific component type. Browse the [Font Icon List](https://www.telerik.com/kendo-angular-ui-develop/components/icons/icon/icon-list) to find the key of the icon you want to override.

```ts Icon Mapping
const COMPONENT_ICON_MAP: Record<string, Record<string, string>> = {
    grid: {
        'chevron-down': 'k-icon k-font-icon k-i-minus',
        'sort-asc-small': 'k-icon k-font-icon k-i-sort-asc-sm',
        // ...
    },
};
```

```ts Service Implementation
@Injectable()
export class MyIconService extends IconSettingsService {
    public override getCustomFontIconClass(iconName: string, component?: string): string {
        return COMPONENT_ICON_MAP[component]?.[iconName] || super.getCustomFontIconClass(iconName, component);
    }
}
```

The following example overrides the Grid icons only. Click **Swap Grid Icons** to toggle the overrides on and off — the TreeList retains the default icons at all times.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/icons/custom-icons/component-type-font/source.txt)

</TabStripTab>
</TabStrip>

## Override Specific Icons with CSS

You can override specific icons for a single component instance without affecting any other component in the same view. Use this approach for isolated customizations where an application-level or component-type override would be too broad.

<TabStrip>
<TabStripTab title="SVG Icons">

To replace a specific SVG icon create a CSS rule that scopes the icon selector to your custom class and set the `content` property to a data URI containing your custom SVG markup.

Ensure your SVG includes the `xmlns` attribute and `style="pointer-events: none;"` for proper rendering and interaction.

```css
thead tr th:nth-child(1) .k-svg-i-sort-asc-small.k-svg-icon {
    content: url('data:image/svg+xml; utf8, <svg xmlns="http://..."><path d="..."></path></svg>');
}
```

The following example demonstrates how to override sort icons per column type in a single Grid instance — string columns use A-Z/Z-A icons, the number column uses 0-1/1-0 icons, and the **Type** column retains the default sort icon.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/icons/custom-icons/instance-specific-svg-css/source.txt)

</TabStripTab>
<TabStripTab title="Font Icons">

To replace a specific font icon create a CSS rule that targets the `::before` pseudo-element of that specific class and set the `content` property to the Unicode glyph code. Scope the selector to a specific column using `:nth-child()` to limit the override to that column only. For Kendo Icons you can check the glyph codes in the [icons list](https://www.telerik.com/kendo-angular-ui-develop/components/icons/icon/icon-list).

```css
kendo-grid thead tr th:nth-child(1) .k-i-sort-asc-small::before {
    content: '\\e41d'; /* arrow-up-a-z */
    font-family: 'WebComponentsIcons';
}
```

The following example demonstrates how to override sort icons per column type in a single Grid instance — string columns use A-Z/Z-A icons, the number column uses 0-1/1-0 icons, and the **Type** column retains the default sort icon.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/icons/custom-icons/instance-specific-font-css/source.txt)

</TabStripTab>
</TabStrip>

## Suggested Links

* [Icon Settings](https://www.telerik.com/kendo-angular-ui-develop/components/icons/icon-settings)
* [Icon Overview](https://www.telerik.com/kendo-angular-ui-develop/components/icons/icon)
* [SVGIcon Overview](https://www.telerik.com/kendo-angular-ui-develop/components/icons/svgicon)
* [API Reference of IconSettingsService](https://www.telerik.com/kendo-angular-ui-develop/components/icons/api/iconsettingsservice)
* [API Reference of ICON_SETTINGS](https://www.telerik.com/kendo-angular-ui-develop/components/icons/api/icon_settings)
