igx-badge
November 19, 2025 ยท View on GitHub
The igx-badge component is an absolutely positioned element that can be used in tandem with other components such as avatars, navigation menus, or anywhere else in an app where some active indication is required.
With the igx-badge you can display active count or an icon in several different predefined styles and sizes.
A walkthrough of how to get started can be found here
Usage
<igx-badge value="8"></igx-badge>
API Summary
| Name | Type | Description |
|---|---|---|
id | string | Unique identifier of the component. If not provided it will be automatically generated. |
type | string | Set the type of the badge to either primary, info, success, warning, or error. This will change the background color of the badge according to the values set in the default theme. |
dot | boolean | Set whether the badge is displayed as a minimal dot indicator without any content. Default is false. |
position | string | Set the position of the badge relative to its parent container to either top-right, top-left, bottom-right, or bottom-left. |
value | string | Set the value to be displayed inside the badge. |
icon | string | Set an icon for the badge from the material icons set. Will not be displayed if value for the badge is already set. |
outlined | boolean | Set whether the badge should have an outline. Default is false. |
shape | string | Set the shape of the badge to either rounded or square. Default is rounded. |
Examples
Using igx-badge with the igx-avatar component to show active status.
<igx-avatar [src]="src">
<igx-badge type="info" value="8"></igx-badge>
</igx-avatar>
Using igx-badge as a dot indicator for notifications.
<igx-badge dot type="success"></igx-badge>
<igx-badge dot outlined type="error"></igx-badge>
Using different badge types.
<igx-badge type="primary" value="1"></igx-badge>
<igx-badge type="info" value="2"></igx-badge>
<igx-badge type="success" value="3"></igx-badge>
<igx-badge type="warning" value="4"></igx-badge>
<igx-badge type="error" value="5"></igx-badge>