Skip to content


Badge generates a small badge to the top-right of its child(ren).

Basic badge

Examples of badges containing text, using primary and secondary colors. The badge is applied to its children.

Press Enter to start editing


Use color prop to apply theme palette to component.

Press Enter to start editing


Here is an example of customizing the component. You can learn more about this in the overrides documentation page.

Press Enter to start editing

Badge visibility

The visibility of badges can be controlled using the invisible prop.


The badge hides automatically when badgeContent is zero. You can override this with the showZero prop.

Press Enter to start editing

Maximum value

You can use the max prop to cap the value of the badge content.

Press Enter to start editing

Dot badge

The dot prop changes a badge into a small dot. This can be used as a notification that something has changed without giving a count.

Press Enter to start editing

Badge overlap

You can use the overlap prop to place the badge relative to the corner of the wrapped element.

Press Enter to start editing

Badge alignment

You can use the anchorOrigin prop to move the badge to any corner of the wrapped element.

    vertical: 'top',
    horizontal: 'right',


You can't rely on the content of the badge to be announced correctly. You should provide a full description, for instance, with aria-label:

Press Enter to start editing

Experimental APIs

Material Design 3

The default Material UI Badge component follows the Material Design 2 specs. To use the M3 version, install the experimental @mui/material-next package.

import Badge from '@mui/material-next/Badge';
<Badge badgeContent={4} />


To learn more about Material UI's M3 implementation, visit the M3 Components documentation.


Use the Base UI Badge for complete ownership of the component's design, with no Material UI or Joy UI styles to override. This unstyled version of the component is the ideal choice for heavy customization with a smaller bundle size.


See the documentation below for a complete reference to all of the props and classes available to the components mentioned here.