Skip to main content Skip to docs navigation

Small status indicators and labels that display concise information such as counts, categories, or brief descriptive text adjacent to other UI elements.

This documentation is a work in progress and may contain incomplete or outdated information. If you have any feedback or suggestions, please open an issue on GitHub.

Variants

Different configurations and states available for badge components to accommodate various labeling requirements, informational displays, and visual emphasis needs. These variants provide flexibility in appearance, content type, and semantic meaning while maintaining design consistency across the system.

Badges

Compact labeling elements that display status information, counts, categories, or other descriptive content. These components serve as informational indicators within interfaces, adapting their appearance and content structure based on context, importance, and information type to provide clear visual communication and maintain consistent user experience across all interface contexts.

Type Variants

Content structure configurations that determine the information display and layout format of badge components. These variants control the type of content and visual presentation to match different informational requirements.

Badge variant example image Badge variant example image

Basic

Text-based badge structure for displaying labels, status indicators, or categorical information. Use for general labeling, feature tags, status displays, or when communicating simple textual information without numerical values.

Badge variant example image Badge variant example image

Count

Number-focused badge structure optimized for displaying numerical values, quantities, or metrics. Use for notification counts, item quantities, progress indicators, or when emphasizing numerical data and measurements.

Style Variants

Visual presentation modes that affect the badge's background treatment and overall appearance within the interface. These variants determine the visual weight and prominence approach for different design contexts and emphasis requirements.

Style variants are implemented as separate Figma components within this file to optimize performance. Each component has the same style and context variants.

Badge variant example image Badge variant example image

Solid

Bold badge styling with full background fill and high contrast appearance. Use for primary badges requiring strong visual presence or when badges need maximum visibility and emphasis within the interface.

Badge variant example image Badge variant example image

Smooth

Subtle badge styling with soft background treatment and integrated appearance. Use for secondary badges that should blend naturally with interface content while maintaining clear visibility and readability.

Badge variant example image Badge variant example image

Outline

Bordered badge styling with transparent background and defined edge treatment. Use for minimal badges requiring subtle emphasis or when maintaining visual hierarchy without adding visual weight to the interface.

Context Variants

Visual styles and semantic meanings that communicate badge purpose, importance, and information type within the interface hierarchy. These variants determine the badge's color treatment, visual prominence, and contextual messaging to guide user attention and convey information significance.

Badge variant example image Badge variant example image

Default

Standard badge styling for general-purpose labeling that doesn't require special emphasis. Use for neutral information, general categories, or non-critical labels that provide helpful context without demanding attention.

Badge variant example image Badge variant example image

Alternate

Alternative styling variant optimized for different backgrounds or emphasized contexts. Use as a visual alternative to default styling in sections with alternate backgrounds or special interface contexts.

Badge variant example image Badge variant example image

Primary

Represents important information that users should prioritize. Use for high-priority labels, featured categories, or primary status indicators that drive core user awareness and engagement.

Badge variant example image Badge variant example image

Secondary

Secondary importance styling for notable but less critical information than primary badges. Use for supplementary labels, alternative categories, or when providing additional context alongside primary information.

Badge variant example image Badge variant example image

Neutral

Neutral styling variant for informational labels with minimal urgency or priority. Use when maintaining visual hierarchy while providing functional information access without demanding immediate attention.

Badge variant example image Badge variant example image

Danger

Critical status styling that signals errors, warnings, or problematic conditions. Use for error states, critical alerts, failed statuses, or any labeling that requires immediate user attention and indicates issues.

Badge variant example image Badge variant example image

Success

Positive confirmation styling for completion and success states. Use for successful operations, completed statuses, positive indicators, or any labeling that confirms successful outcomes and achievements.

Badge variant example image Badge variant example image

Warning

Cautionary styling variant that signals attention-required situations or potential concerns. Use for warning states, pending conditions, approaching limits, or labels that require user awareness and possible action.

Badge variant example image Badge variant example image

Info

Informational styling variant for knowledge-based content and helpful guidance. Use for informational labels, helpful tips, feature explanations, or labels that provide valuable context and learning opportunities.

Badge variant example image Badge variant example image

Black

High-contrast styling variant that maintains black appearance regardless of theme. Use for maximum visual impact in special contexts or when consistent dark styling is required across theme variations for critical labeling.

Badge variant example image Badge variant example image

White

Clean contrast styling variant that maintains white appearance regardless of theme. Use for prominent labels requiring neutral treatment in special contexts or when consistent light styling is needed across theme variations.

Size Variants

Different dimensional scales for badge components to accommodate various layout requirements and visual hierarchies. These variants maintain proportional relationships while adapting to different design contexts and space constraints.

Badge variant example image Badge variant example image

Large

Expanded badge size designed for high-visibility labeling requiring more emphasis, such as important status indicators or primary categorical information. Use for prominent labels in hero sections, mobile interfaces, or when enhanced prominence is required.

Badge variant example image Badge variant example image

Medium

Standard badge size providing balanced proportions for most badge implementations. Use as the default size for primary and secondary labels across general interface contexts where optimal visibility and readability are required.

Badge variant example image Badge variant example image

Small

Compact badge size optimized for dense layouts and secondary labeling. Use in constrained spaces, inline content, or when multiple badges need to fit within limited screen real estate.